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ABSTRACT 


The design and execution of a networked virtual environment (NVE) are 
challenging tasks made even more difficult by the fact that NVEs are becoming more 
complex and difficult to manage. In a distributed environment, each simulation not only 
computes its own behaviors and publishes them to the network, but it must accurately 
represent all other entities participating in the NVE. To simplify this task, this thesis 
implements method to make distributed simulations dynamically extensible, flexible, 
specific, and consistent. Bamboo provides the ability to dynamically extend the virtual 
environment by defining a convention by which plug in modules can be added during 
simulation runtime. The HLA provides the network communication layer that transports 
entity state updates to all members of the distributed simulation. These two tools combine 
to create a unique solution to problems inherent in designing modern networked virtual 
environments. The implementation is dynamically extensible which increases the flexibility 
implementers have in designing virtual environments. The HLA transports the entity 
updates and the module name that must be used to represent the entity. This method 
allows programmers to design only their module because modules representing other 
entities will load as needed during the execution. This method of implementing virtual 


environments that promises to streamline the design and implementation process. 
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I. INTRODUCTION 


A. MOTIVATION 


The design and execution of a networked virtual environment (NVE) are 
challenging tasks made even more difficult by the fact that NVEs are becoming more 
complex and difficult to manage. In a distributed environment, each simulation not only 
computes its own behaviors and publishes them to the network, but it must accurately 
represent all other entities participating in the NVE. To simplify this task, a method must 
be devised to make distributed simulations dynamically extensible, flexible, specific, and 
consistent. A dynamically extensible virtual environment would allow users to change the 
executable at runtime to whatever state is specified by the user. The challenge is to design 
a system that allows users to design entity definitions that can be loaded and unloaded 
during execution. With true dynamic extensibility comes flexibility, and designers are not 
tied to compile time determinations of behavior. Consistency in this sense means all sites 
participating in the NVE need the same definitions for each entity and the terrain model 
being used. Finally, the designer of a specific simulation, such as a tank simulator, should 
not need to design the other entities that will be depicted in the simulation. These remote 
objects should be program objects that can be added as needed during execution. This 
approach will allow NVE implementers and programmers the flexibility to design and run 
NVEs in real time without the problems of inflexibility and static design inherent to 


distributed simulation. 


B. BACKGROUND 


There are many examples of NVEs that use different methods of communicating 
entity state and ensuring consistency between simulation locations. Examples include 
DIVE [1] and BRICKNET [2]. These systems share one characteristic. They are defined 
at compile time and are unchangeable during execution. They allow dynamic allocation of 
memory but the definitions of each entity are defined at compile time and are 
unchangeable. 

The DIVE core uses peer-to-peer communication between shared virtual worlds. 
All DIVE processes connected to the same world are identical. A DIVE process can 
choose what world it is a part of but it can only be a member of one world at a time. 
DIVE is limited by the paradigm of distributed, shared memory. This paradigm creates 
significant network traffic trying to keep the shared memory consistent from process to 


process. While DIVE shared virtual worlds may change during runtime, the method of 
communication and the abilities of the system are previously defined and are not extensible 
at runtime. 

BRICKNET allows the exchange of objects and object updates through 
BRICKNET servers. While it does distribute processing on multiple servers, entities 
require the server to update state and define behavior. Workstations are primarily used to 
render the graphics for the user. Furthermore, BRICKNET object updates are predefined 
and the update protocol cannot be modified. 

Finally, distributed interactive systems (DIS) like NPSNET [3] are designed on the 
premise that each site could build their own simulation and choose how to represent each 
type of entity without regard to the consistency of this representation across the network. 
Each site could have its own terrain model and its own representations for each entity 
type. Because of these inconsistencies, DIS simulations are plagued with discrepancies 
between entity position and orientation and line of site computations related to the terrain 
models. DIS is highly enumerated and the packets containing entity state are large and 
mostly redundant. These inconsistencies complicate interactions between entities because 
the terrain may provide different line of sight computations from one simulation to the 
next. Additionally, the actual polygonal representation and behaviors of the entity may not 
be consistent among workstations in the distributed simulation. This causes excess 
network traffic to solve simple interactions between entities and keep entity state updated 
accurately between simulation sites. 

Until now, there was no way to ensure all simulation sites had the proper 
polygonal and behavioral representation for all entities participating in the virtual 
environment. A new system, Bamboo [4], provides such a capability by providing 
simulations a framework to dynamically load and unload program modules as the situation 
changes in the virtual environment. High Level Architecture (HLA) [5] replaces DIS and 
provides the network communication capabilities. By implementing the simulation as a 
group of program modules, designers solve the problem of ensuring that every site running 
in the NVE is consistent with every other. The designer just ensures every participant in 
the NVE knows the network location of all the program modules making up the NVE. 
Then, as the virtual world executes, each site loads and unloads modules as needed. All 
simulation sites have the same representations for each entity as well as its associated 
behaviors and controls. 

This thesis describes an implementation that uses Bamboo to handle the dynamic 
nature of modern NVEs, and HLA to handle the communication between each simulation 


site. The following sections provide an overview of Bamboo and HLA features and how 


2 


they apply to this implementation. Later chapters provide a detailed description of both 


systems. 


C. BAMBOO 


Bamboo enables dynamically scaleable virtual environments hosted on a network. 
It achieves this goal by an efficient implementation that provides direct support for the key 
issues pertaining to VE development. These issues include dynamic extensibility, module 
dependency, and event handling [4]. Bamboo’s most notable feature is its ability to 
dynamically extend its capabilities during run time. It achieves this goal by implementing a 
plug-in metaphor similar to that used by commercial packages like PhotoShop [6] and 
Netscape [7]. __ In addition to the plug-in metaphor, Bamboo implements a system that 
allows the user to extend the executable through a series of callbacks that a newly added 
module allocates at load time. The event handler simply provides an abstraction for 
handling system-generated events. The event handler uses the callback handler to notify 
registered parties of an event. Bamboo receives this notification as a callback. Module 
dependency provides a system to ensure that modules which are required by other 
modules are loaded first before the depending module. Bamboo uses callback handlers so 
multiple callbacks respond to a single event. This is a cursory introduction to the features 
and capabilities of Bamboo. Chapter two provides a detailed description of the Bamboo 


system. 


D. HIGH LEVEL ARCHITECTURE 


The High Level Architecture (HLA) is the Department of Defense standard for 
simulation interoperability [5]. HLA is not software. It is an architecture that provides 
standard methods of defining how distributed simulations will communicate. It is a set of 
specifications that define data objects. These standards are specified in the HLA Interface 
Specification and the Object Model Template (OMT). The HLA Interface Specification 
defines the interface between the simulation and the software that will provide the network 
and simulation management services. The Runtime Infrastructure (RTI) is the software 
that provides these services. The OMT prescribes a common method for recording the 
information that will be produced and communicated by each simulation participating in 
the distributed exercise. This discussion of HLA is continued in detail in Chapter 3. 


E. THESIS ORGANIZATION 


This thesis is organized into the following chapters: 


Chapter I: Introduction. Outlines the organization of the thesis and addresses 
the significance of introducing and evaluating a new method for implementing 
a networked virtual environment. 


Chapter II: Bamboo. Discusses in detail the current implementation of 
Bamboo and how its capabilities are suited for a networked virtual 
environment implementation. 


Chapter III: High Level Architecture. Discusses in detail the current 
implementation of the HLA and how its capabilities are suited for a networked 
virtual environment implementation. This chapter includes a detailed 
discussion of the run time infrastructure (RTI) and how its capabilities are 
exploited in this implementation. 


Chapter IV: Implementation. Describes the development of the experimental 
virtual environment that illustrates the power of combining Bamboo and HLA. 


Chapter V: Results and Limitations. Describes performance results for the 
implementation and certain limitations discovered during development. 


Chapter VI: Conclusions and Recommendations. Discusses the significance of 
the results and gives ideas as to future work that should be completed in this 
area. 


Il. BAMBOO 


A. INTRODUCTION 


Bamboo enables dynamically scalable virtual environments hosted on a network 
[4]. It achieves this goal by an efficient implementation that provides direct support for 
the key issues pertaining to VE development. These issues include dynamic extensibility, 
event handling, and module dependency. By addressing these issues, Bamboo provides 
the ability for the system to dynamically configure itself during runtime. Specifically, this 
framework provides the ability to discover simulation objects on the network at runtime 


and automatically load the correct module to represent the entity. 


B. DYNAMIC EXTENSIBILITY 


Bamboo’s most notable feature is its ability to dynamically extend its capabilities 
during run time. It achieves this goal by implementing a plug-in metaphor, then extends 
the idea by adding module dependency, a generalized method of extending the executable 


and a generalized event handler. 


A Dependency 


Bamboo extends the plug-in metaphor by adding inter-module dependencies. 
Tracking inter-module dependencies could be complex. Fortunately, as Bamboo loads 
each module, it verifies that dependent modules load first. If they are not loaded, it 
automatically loads them without specific interaction with the user. Using Figure | as an 
example, assume M3 is already loaded. If M4 loads later, the system verifies the presence 
of M2 in memory. Bamboo loads M2 if it is not in memory. As M2 is being loaded 
Bamboo verifies the presence of M1. M4 finally loads because Bamboo verified all its 


dependencies [4]. 





Figure 1: Module Dependency View 


2: Extending the Executable 


Dynamic loading of program modules does not in itself ensure dynamic 
extensibility. Bamboo uses a callback handler that allows each module to attach and 
remove itself from the process’s execution loop when being paged in and out of memory. 
The callback handler derives from objects that can be named so it is easily located and 
manipulated. The callback itself is recursive and provides two callback handlers, one just 
before callback execution and one directly after. This allows grouping of like 
functionality. For example, rendering engines implement some form of app, cull and draw 
as a pipeline. Users refer to surrounding areas as pre and post app, pre and post cull, and 
pre and post draw. The executable begins to resemble a tree of callbacks. Figure 2 
illustrates how using callbacks and callback handlers to extend the executable begins to 
resemble a tree of callbacks. For instance, a user module may load itself and depend to 
the visual and keyboard modules. At load time, the user module defines callbacks that 
provide execution time for the logic in the module. Furthermore, any pruning or pausing 
of sub-trees automatically includes its children. Therefore if a callback handler is deleted, 
all of its associated callbacks are also deleted without specific user interaction. 
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Figure 2: Extending the Executable 


3: Event Handling 


The event handler simply provides an abstraction for handling system-generated 
events. The event handler uses the callback handler to notify registered parties of an 
event. Bamboo receives this notification as a callback. Bamboo uses callback handlers so 
multiple callbacks respond to a single event. For example, a module that captures 
keyboard events would monitor the keyboard in a separate thread listening for keys 
identified by the user. In figure 2, the Event Handler Module has multiple callbacks on 
two separate keys. When a key is pressed, then the callbacks are executed in the order 


specified. 
c. BAMBOO CONCLUSION 


Bamboo improves on the plug-in metaphor in three distinct ways. It provides a 
convention for the definition of program modules. Second, it generalizes a method to 
extend the executable, and third, it provides a method to build dependencies between 
modules. Using these features, Bamboo overcomes many of the pitfalls of monolithic 
virtual environment architectures by providing modular components and a dynamically 


extensible runtime executable. 


Il. HIGH LEVEL ARCHITECTURE 


A. INTRODUCTION 


The High Level Architecture (HLA) provides a common architecture for reuse and 
interoperation of simulations. This means that simulations designed for a specific purpose 
may be reused in a different application using che HLA concept of a federation: a 
composable set of interacting simulation participants - federates. The intent is to provide 
a Standard architecture under which simulations are designed so that they can be reused 
thereby reducing the time and cost required creating a new environment for a new 
purpose. [5] 

The Object Model template (OMT) [8], HLA rules [9] and the Interface 
Specification (IF Spec) [10] define the HLA standard. A final component of the HLA is 
the Runtime Infrastructure (RTI). The OMT describes the essential sharable elements of 
the simulation or federation in ‘object’ terms. In the HLA sense, objects are collections of 
attributes that describe simulation entity state that are communicated between federates 
Operating in the federation. Second, the IF Spec describes the runtime services provided 
to each federate by the RTI. The RTI is the software component of the HLA that 
supports the exchange of data defined by the OMT component. Finally, The HLA rules 
Summarize the key principles behind the HLA. 


B. OBJECT MODEL TEMPLATE 


The HLA is designed to facilitate interoperability. Hence, the OMT is designed to 
provide a means for open information sharing across the simulation community. The 
OMT does not constrain the content, but provides a streamlined format for 
communicating to the other users, who may reuse the simulation, and the data inputs and 
outputs of the simulation. The HLA specifies two types of object models: the HLA 
Federation Object Model (FOM) and the HLA Simulation Object Model (SOM). The 
FOM is a specification of the exchange of public data among the participants in a HLA 
federation. Those participants are called federates. The HLA FOM describes the set of 
objects, their attributes and interactions that are shared between federates in a federation. 
The SOM describes the simulation (federate) in terms of the types of objects, attributes, 


and interactions it can offer to future federations. 


1. Federation Object Model 


The FOM requires information concerning the object classes, object interactions, 


class attributes, interaction parameters and a lexicon describing each of the above [8]. 


a. Object Class Structure Table 


Each object class must be named and its relationship to other classes must 
be defined. All classes must be defined and described in the lexicon. The result is a table 
sumilar to Table 1 [8]. 


Object Class Structure Table 
<class>(<ps>) |[<class>(<ps>)] <class> (<ps>)} [.<class>(<ps>)]* <aeb 


Ieeless> (eps>)]__ DS> <class> (<ps>)} [,<class>(<ps>)]*lf<aeb 
masta <class> (<ps>)] [,<class>(<ps>)]*Il [<reb 
{<class>(<ps>)] [eek pap 1. <class > (<ps>)] [,<class>(<ps>)]"l[<e6 


rae 9S> es <ps>)] [,.<class> (<ps>)]*Il [<reB 


<clas s>(<ps >) ——— <class> (<ps>)] L<cla Ds >}]*) [<reb 
peter ise DS> <class> (<ps>)] [,<class> (<ps>)]*l [<areb 


Air Vehicle S) | Fixed Wing (S) Fighter-Attack (S) F-14 (PS 
F-16 (PS 
F-18 (P 


Bomber aa B-1B(P 
pees AE 2 (PS 





Rotary Wing (PS) 


Table 1: Object Class Structure Table 


This table shows the object model used in a federation. Class Air Vehicle is the base class 
for all flying entities. Class Fixed Wing and Rotary wing inherit from Air Vehicle, while 
Fighter-Attack and Bomber inherit from Fixed Wing. Then F-14, F-16, etc. describe the 
specific types of aircraft depicted in the federation. The (P), (S) and (PS) stand for 
publishable, subscribable and both, respectively. This means that individual federates can 
request — subscribe - certain object attributes from the federation. A federate may also 
provide — publish - object attributes to the federation. If a federate represents an entity 
that must interact with entities of the same type, that federate might publish and subscribe 
to the same Object Class. 
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b. Object Interaction Table 


The object interaction table shows the interaction class structure for the 
federation. Table 2 shows the interaction class structure [8]. An interaction is an explicit 
action taken by an object that can optionally be directed toward other objects. In this 
case, Weapon Detonate is the base interaction class, and Weapon Detonate at Air Target 


and Weapon Detonate at Ground Target are both inherited from Weapon Detonate. This 

















table also lists the initiating and receiving object and the affected attributes for each object. 
Object Interaction Table 


Interaction Structure Initiating Object Recelving Object/Area Ina 
Interaction Sense! 
Parameters 
Attributes 
<class> ea [<¢lass>] [<attnbute>] ae 
[.<class>]° [.<attnbute>]° [.<class>J° [.<aftnbute>]° ae a 
[(<comment>)]° [(<comment>)]° 
[<interaction>] <class> [<attnbute>] tea [<attnbute>] [<parameter] 
[,<class>]° [.<attnbute aT. [.<class>f eee eee [.<parameters]° 
[(<comment> [(<co i 
<interaction> [<:nteraction>] <Class> ey [<attnbute>} [<parameter>] 
[.<class>]° [. ae As pec luanhdlts [.<pararnsters]° 
ere 
Weapon Detonate Veloc my, Air Vehicle Velocty, Weapon Location, 
at Arr Target Acceleration, Acceleration, Warhead, 
Werght, Weight, Weapon Atttude, 


Weapon Detonate 
at Ground Target . 








[<interaction>] 






Table 2: Object Interaction Table 


The last column in the table shows the three basic categories of interaction: 


e Initiates (1): indicates that a federate is currently capable of initiating and sending 
interactions of the type specified in that row. 


e Senses (S): indicates that a federate is currently capable of subscribing to the interaction 
and utilizing the interaction information, without necessarily being able to effect the 
appropriate changes to affected objects. 


e Reacts (R): indicates that federate is currently capable of subscribing and properly 


reacting to the interactions of the type specified by effecting the appropriate changes to 
any owned attributes of the affected objects. 


In a FOM definition, all of the above are valid entries. There would not be a listing if 


there was not a federate responsible for the interaction. 
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a. Attribute/Parameter Table 


Finally, the Attribute/Parameter Table [8] defines characteristics pertinent 
to each Class/Interaction described in Table | and Table 2. Interactions are published by 
and subscribed to by federates depending on the structure of the federation. Table 3 is the 
Attribute/Parameter Table for a Tank Object and the Weapon Detonate Interaction. For 


each Object/Interaction the 


Att ibute’ Accuracy 
Inter action Perameter cok Cardinaltty | Resolution Accuracy Condition Ps Condition T/A | UA 


<units> |<resolutiom> | <accuracy> |<condtion> 


<rate> | 
<datatype> |[<scze>] oe cee <condttion> ane <ta>} <up 


| sf fcszem) | 


a L fa 

<datatype> <condtion> | <type> <conditon> <ul> 
<rate> | 

seem fevton oe [Sate an] 


os ene ae 


<class> | <attrbute>| ca 
<Interaction> <parameter> | <datatype> a <units> |<resoktion> | <accuracy> <condrton> <u> 


Aree Float 1 m2 0.1 m2 pertect always conditional jscenevents {TA |UR 


CG LS 
ete i 
Poston [RecmaTipe|t [ve ime mode [vor ——|TA_[UR 


Weapon 
Detonate Warhead Wh_Type Wa |tve 





Table 3: Attribute/Parameter Table 


attributes or parameters are defined and characterized by multiple descriptors like data 
type and units of measure. The second to last column, Transferable/Acceptable refers to a 
federate’s ability to transfer or accept the responsibility to update the specified attributes 
for a particular entity. For a FOM, the only acceptable entries are (TA) for 
Transferable/Acceptable or (N) for Not Transferable/Acceptable. The last column refers 
to a federate’s capability to update (U) and reflect (R) attributes or parameters. In a 
FOM, all attributes or parameters should be marked both updatable and reflectable. 


IZ 


2 Simulation Object Model 


A FOM is the union of all SOMs used to define the federation. The SOM uses the 
same templates as the FOM. The Object Class Table in Table 1 describes the object 
classes represented in the federation. A SOM object class structure table would designate 
which classes the federate publishes (P) and which it has the capability to subscribe (S). 
For example, the F-16 federate might publish the F-16 object and subscribe to air vehicle 
so it would know the location and speed of all other aircraft in the federation. Similarly, 
the Object Interaction table would differ in the last column because the federate must 
identify what interactions it has the capability to process. The F-16 federate might put a 
(R) in the last column of Table 2 to indicate that it reacts to a Weapon Detonation at an 
Air Target. Additionally, a (1) might go in the last column for Weapon Detonate at 
Ground Target to show that the F-16 federate initiates the interaction to fire weapons at a 
ground target. Finally, the last two columns in the Attribute/Parameter Table would be 
modified to show what capabilities the federate has in regards to its ability to transfer and 


accept attributes or update and reflect attributes. 


5: FOM/SOM Lexicon 


To achieve interoperability between simulations, all data required by the federation 
must be fully explained. It is not enough to merely specify the classes of data required by 
the templates above. The semantics of this data must also be explained. ,The FOM/SOM 
Lexicon provides a means for federations to document the definitions of all terms utilized 
during construction of FOMs, and for individual federates to document the definitions of 
all terms provided in their SOMs. 


C. INTERFACE SPECIFICATION 


The IF Spec [9] describes the runtime services provided to the federates by the 
RTI, and from the federates to the RTI. There are six classes of service. Each defines a 
specific set of functions that pertain to a particular type of transaction that must be 
accomplished to properly manage the federation. There are two locations where the 
function definitions reside: the RTI ambassador and the federate ambassador. The RTI 
ambassador 1s the software component provided by HLA and contains all the functionality 
required to accomplish communication to the network. The federate ambassador is the 
RTI’s interface to the federate. To pass data to the federate, the RTI ambassador makes 
function calls to a user defined federate ambassador. The RTI ambassador is the same for 


all federates but the federate ambassador is different for each federate. A full explanation 
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of each function can be found in the HLA IF Spec. The following discussion deals mainly 


with the purpose of each management service. 


1. Federation Management 


Federation management services offer the basic functions required to initiate the 
federation, add federates and delete federates as the federation finishes execution. These 


services include Create, Join, Pause/Resume, Resign and Destroy federation. 


De Declaration Management 


Declaration management defines the services required to support efficient 
management of data exchange. It does this by providing the services that allow federate’s 
to identify to the RTI ambassador the object and interaction classes they will publish and 
subscribe. This service includes Publish, Subscribe, and Control actions on specific object 


classes and interactions. 


3: Object Management 


Object management services refer to all the functions required to manage the 
update of object attributes during federation execution. The services include Request 
Object ID numbers, Update object attributes, Sending Interactions, Receiving object 
updates, Receiving interactions, Deleting objects and Changing transportation 


characteristics. 


4. Ownership Management 


Ownership management refers to the dynamic transfer of ownership of object 
attributes during federation execution. The services include Request attribute ownership, 


Divest Attribute ownership and Release attribute ownership. 


5. Time Management 


Time management services support the synchronization of runtime simulation data 
exchange. The current HLA time management service provides support for time-step and 
event-driven simulation systems but support for platform level real-time simulations is 
limited to wall clock time. 
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6. Data Distribution Management 


Data distribution management supports the efficient routing of data among 
federates during the course of a federation execution. This service allows federates to 


identify regions of interest and limit attribute to entities that fall into those regions. 


D. HLA RULES 


There are ten basic rules that define the responsibilities and relationships between 
HLA federates and the federation. There are ten rules: five rules apply to federations and 
five rules apply to federates [10]. 


1. Federation Rules 


e Rule 1: Federations shall have an HLA FOM, documented in accordance with the 
HLA OMT. 


e Rule 2: In a federation, all object representation shall be in the federates, not in the 
runtime infrastructure. This means that the RTI cannot be used to track entity state. All 
entity representations are defined by the federate and communicated to other federates via 


the RTT. 

e Rule 3: During a federation execution, all exchanges of FOM data among federates 
shall occur via the RTT. 

e Rule 4: During a federation execution, federates shall interact with the RIT in 


accordance with the HLA IF Spec. The only way to interface with the RTT is through the 
RTI ambassador and the services provided in that class 


e Rule 5: During a federation execution, an attribute of an instance of an object shall 
be owned by only one federate at any given time. No attribute can be published by more 
than one federate at a time. 


ee Federate Rules 


e Rule 6: Federates shall have an HLA SOM documented in accordance with the 
HLA OMT. Each simulation must describe the functionality it will provide to the 
federation. The federation is not required to use all the functionality supplied by the 


federate. 

e Rule 7: Federates shall be able to update and/or reflect any attributes of objects in 
their SOM and send and/or receive SOM object interactions externally, as specified in their 
SOM. 

e Rule 8: Federates shall be able to transfer and/or accept ownership of attributes 


dynamically during a federation execution, as specified in their SOM. 


IS 


e Rule 9: Federates shall be able to vary the conditions (e.g., thresholds) under which 
they provide updates of attributes of objects, as specified in their SOM. 


e Rule 10: — Federates shall be able to manage local time tn a way that will allow them 
to coordinate data exchange with other members of a federation. Non-time managed 
federates manage time internally in their own way, but time managed federates must manage 
time in such a way so it appears there is only one clock. 


E. HLA CONCLUSION 


The HLA architecture is designed to improve the method of simulation interaction 
by making certain types of simulation systems reusable among disparate simulation 
applications. It accomplishes this goal by providing a standard method of communicating 
simulation capabilities (SOM) and a standard method of defining how those simulations 
will communicate on the network (FOM). The RTI provides the communications link to 
manage the operation of a federation using the IF Spec. The HLA rules link it all together 
by providing guidelines that ensure designers will use all the components is such a way as 


to accomplish the goal of reusable inter-operating simulations 
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IV. IMPLEMENTATION 


A. INTRODUCTION 


The goal is to provide a dynamic, flexible, and consistent environment for three- 
dimensional networked virtual environments. Consistency is accomplished by ensuring all 
modules are available locally or via the network from a centralized location. As the 
simulation executes, users decide which terrain module to use and which simulation 
entities will populate the environment. Bamboo provides the ability to dynamically load 
and unload modules. The ability to add a module provides dynamic extensibility. It is the 
ability to unload modules that makes the system flexible. Flexibility requires that the 
implementers can change the virtual environment on the fly without restarting. 

To this end, the wnplementation has three major components: the HLA 
administration module (amHLAAdmin), entity modules, and terrain modules. The 
amHLAAdmin module manages the communication layer (RTI), module loading and 
unloading, and all participating entity objects. Each entity module represents the behavior 
and polygonal representation for each entity. The terrain modules are the same as the 
entity modules but they must be identified as terrain for the amHLAAdmin module. These 
modules make up the core of this implementation. Each component is described in detail 


in the following sections. 


Ll. HLA Administration Module (amHLAAdmin) 


The amHLAAdmin module manages HLA RTI communications, Bamboo function 
calls, the execution window, and entities in the environment. All modules designed for the 
implementation depend on the amHLAAdmin module. Therefore, Bamboo ensures it 
loads before any entity or terrain module. Similarly, the amnHLAAdmin module depends 
on various modules being loaded before it. Figure 3 shows the module dependency tree 
for a typical execution. Notice that amEntity and amTerrain depend on amHLAAdmin, 
and that amHLAAdmin depends on Visual, Keyboard, and amPageModule. 


Bamboo 


a TN 


Keyboard amPage Module 


‘eS 


ae 


amHLAAdmin 


J \ 


amEntity amTerrain 





Figure 3: Implementation Module Dependency View 


Since the amHLAAdmin module must communicate with the RTI and 
entity/terrain modules, the API and pure virtual class provide the interface to accomplish 
this communication. Essentially, the amHLAAdmin module instantiates the Admin class 
object. Through static functions, the Admin class provides the API for entity/terrain 
modules to communicate with the RTI and manage instances of their entities. Each 
entity/terrain class must inherit from amObject. This object defines the interface for the 
Admin object to communicate with entity/terrain modules. 

Figure 4 shows the object model used by this implementation. This figure 
illustrates the relationship between the Admin object and the entity modules. It also shows 
how the pure virtual class amObject is used to ensure that each federate transmits and 
receives all information pertinent to the federation. An entity update coming from the 


network begins in the RTI ambassador receive buffer. 


amEnuty Module 
Entity Object 


a 
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amHLA Admin 
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Figure 4: Object Interface 
Next, the RTI ambassador calls the AdminFederateAmbassador-::reflect Attribute V alues() 


function in the federate ambassador). The federate ambassador is the RTI ambassador’s 
interface into the federate. This function simply calls the Admin object function to pass 


the AttributeHandleValuePair to the appropriate entity. 


Called by the RTI Ambassador to pass 
the attributeHandleVvaluePairSet to a specific entity 


void AdminFederateAmbassador::reflectAttributeValues 
{ RTI::ObjectID theObject, 
const RTI: :AttributeHandleValuePairSeté& theAttributes, 
RTI: :FederationTime theTime, 
const RTI::UserSuppliedTag theTag, 
RTI: :EventRetractionHandle theHandle } 
throw (RTI: :ObjectNotKnown, 
RTI: :AttributeNotKnown, 
RTI::InvalidFederationTime, 
RTI: : FederateInternalError) 
{ 
Admin: :receiveUpdate(theObject, theAttributes, theTime, theTag, theHandle) ; 
}// end reflectAttributeValues 


Objectip 1s the ID number for the specific entity 
The userSuppliedtag specifies the module name. 
The other parameters are not used in this implementation. 





Figure 5: Federate Ambassador Code Fragment 
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The federate ambassador calls the Admin::receiveUpdate() function in the Admin 
object (Figure 6). This function locates the entity object, an amObject type, in the object 
list. If the object exists, it is updated. If it does not exist, the Admin object checks to see 
if the module is loaded. If the module is loaded, then another object representing that 
entity is instantiated. If the module is not loaded, it is loaded and an object representing 


the entity is instantiated. 


Called by the Federate Ambassador to pass 
the attributeHandleValuePairset to a specific entity 
managed by the Admin object 


void Admin: :receiveUpdate( RTI: :ObjectID theObject, 
const RTI: :AttributeHandleValuePairSeté theAttributes, 
RTI: :FederationTime theTime, 
const RTI: :UserSuppliedTag theTag, 
RTI: :EventRetractionHandle theHandle ) 


Locates amObject in list 


amObject* tmp = Admin:: findSimEntity(theObject) ; // find the correct object 


i€ (tmp) Pass attributes to amObject 


tmp->receiveUpdates (theObject, theAttributes, theTime, theTag) ; 
else { // add module if necessary or add simEntity 
if (Admin: :moduleLoaded (theTag) } { // is module loaded 


Add entity of module already loaded 


cout << "adding new ° << theTag << endl; 
Admin: :addSimEntity(theTag,theObject); 
}// end if 


ese ‘| Load module and add entity from module 


cout << "Loading Module °* << theTag << endl; 
Admin: : loadModule (theTag)} ; 
Admin: :addSimEntity(theTag, theObject); 





Figure 6: Admin Object Code Fragment 


The Admin object iterates the lIist of entities and calls the 
EntityObject::receiveUpdates() function of the appropriate entity (Figure 7). This 
function is defined in the amObject pure virtual class. This function iterates the 
AttributeHandle ValuePair and sets the appropriate state variables in the entity object. 
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Called by the Admin object to pass 
the attributeHandlevaluePairSet to the entity 


void Boid: :receiveUpdates( RTI::ObjectID oid, 
const RTI: :AttributeHandleValuePairSeté theAttributes, 
RTI: :FederationTime theTime, RTI. :UserSuppliedTag theTag) 


RTI: :AttributeHandle attrHandle; 
unsigned long valueLength,; 


+ el 
| Iterate theattributes and set the values in the entity object | 


for ( unsigned int i = 0; i < theAttributes.size(); i++ ) { 

attrHandle = theAttributes.getHandle( i ); 

if ( attrHandle == Admin: :getPositionAttrHandle() ){ 
npsVec3£ tmp; 
theAttributes.getValue( i, (char*)&tmp, valueLength }; 
setPosition(tmp) ; 

}/fend if 

else if ( attrHandle == Admin: :getOrientationAttrHandle() } { 
npsQuaternion tmp; 
theAttributes.getValue( i, (char*)&tmp, valueLength }); 
setOrientation(tmp); 

}// end else if 

else if ( attrHandle == Admin: :getVelocityAttrHandle() ) { 
npsVec3f£ tmp; 
theAttributes.getValue( i, (char*)&tmp, valueLength ); 
setVelocity (tmp) ; 





Figure 7: Entity Object Code Fragment 


The Admin object is the portion of the anHLAAdmin module that implements the 
Admin API. This API is fully described in Appendix A: Implementation Tutorial. Users 
apply the Admin API to ensure their modules are managed as part of the HLA federation 
and the entities they represent are properly registered and updated by the RTI. Proper use 
of the API insures that the federation will comply with HLA Rules. 

The amHLAAdmin module loads and unloads modules in two ways: either 
automatically at the request of the system or explicitly at the request of the user. The 
Admin class defines certain API functions that load and unload modules at the request of a 
module or the system. Finally, the amHLAAdmin module loads user requested modules 
using a separate module called the amPageModule on which it depends. This module 
loads automatically when the anHLAAdmin module loads. The amPageModule executes 
the Bamboo calls that load and unload user requested modules. It installs two keyboard 
events that the implementer uses to arbitrarily load and unload modules. 

The amHLAAdmin module manages all of the simulation entities. Functionality 
related to this task are the HLA object management tasks like registering and deleting 
objects and ensuring state updates transmit to the correct entity. The amObject class, that 
all objects inherit from, allows the amHLAAdmin module to iterate its list of simulation 
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entities and update each object based on its ObjectID, an identification number provided 
by the RTT. 

Each module’s capability means nothing unless the executable is extended to 
include the new module. Figure 8 illustrates the execution tree used in _ this 
implementation. The amHLAAdmin module created the symbols in bold outline when the 
module loaded. AI is a callback attached to the main callback handler created by the 
Bamboo core. Al] “ticks” the RTI to provide CPU time to the RTI ambassador and the 
federate ambassador. This callback drives the federate by processing all updates and 
providing them to the correct simulation entity. A2 is a callback attached to the draw 
callback handler of the Visual module. This callback calls the display function of all 
simulation objects using a call to a virtual function defined in amObject that all simulation 
entities must implement. Finally AK is the callback representing all keyboard events that 
are processed by the amHLAAdmin module. 


HLAAdmin 
Module(A ) 





Figure 8: Execution Callback Tree 
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Z. Simulation Entities (amEntity/amTerrain) 


As the VE executes, if an entity is updated that is not currently represented on the 
local machine, the RTI initiates the discovery process. The UserSuppliedTag, a character 
string that is transmitted with each update handle value pair, represents the module name. 
The handle value pair is the HLA method of creating a byte array for transmission on the 
network. If this module is already loaded, then another object from this module is 
instantiated. If the module does not exist, then Bamboo loads it and instantiates an object 
that represents the newly discovered entity. 

Each simulation entity is a Bamboo module. Each module has two major 
components: the object’s polygonal representation and its general behavior. Therefore, 
when a module loads as a result of a remote object update, the user collects all the 
controls of that module. Then Bamboo plugs the module into the local event loop so local 
processing can compute entity appearance and behavior. Figure 4 shows the entity 
module loaded and inserted in the executable with two sets of callbacks. B1 is the preapp 
callback that gives the user the ability to control the object with keyboard input. BK is the 
callback for all the keyboard inputs defined by the module. 

Because this system passes behaviors along with polygonal representation, there is 
an opportunity to reduce network traffic by reducing the details of entity behavior that 
previous systems transmitted via the network. This occurs because each entity computes 
its behavior locally not from a remote location. For instance, each entity provides collision 
event behavior locally without the need for multiple interactions transmitted across the 
network. Now the entity module notifies the federation only that a collision occurred, not 
resulting detailed state changes. Each entity computes those state changes locally as a 
result of the interaction. The result is a series of simulation actors whose behaviors and 
polygonal representations load dynamically at runtime. This allows simulation managers 
to easily experiment with the content of the environment by adding and subtracting 
functionality at runtime. The tendency is to think that this applies only to the graphically 
represented entities but it could mean that data loggers or analysis modules dynamically 
load and unload to collect and analyze simulation data. Bamboo provides an 
unprecedented method of adding functionality to an executing networked virtual 


environment. 


>, Graphics Rendering 


Bamboo’s Visual module renders the graphical objects in the scene. The 
amHLAAdmin module and the entity modules update the object's position and orientation. 


he 


Each entity module registers callbacks with the Visual module to ensure accurate 
rendering of the simulation entity. These callbacks call the appropriate functions when the 
system needs to render the graphical representation of each entity. See Figure 4 for the 


callback tree representing this implementation. 


B. FEDERATION OBJECT MODEL/SIMULATION OBJECT MODEL 


This implementation has a simple FOM. Table 4 displays the FOM tables for the 
implementation. The FOM and SOM are the same for this implementation because each 
federate is based on the amHLAAdmin Module common for all federates. The FOM 
defines the Entity State Object and its attributes that define the state of the object. The 
Entity State Object defines the attributes that will be communicated to the network. Do 
not confuse this object with the software objects defined in the implementation. Those 
C++ objects may define more variables that define their state but are not communicated to 
the network. The FOM also defines a very simple interaction called Collision. Its only 
parameter is the ObjectID number assigned to the entity that has been collided with. The 
purpose of this interaction is to communicate to the federation the ObjectID of the entity 
that was damaged. Each federate then updates the state of that entity. 
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Table 4: Implementation FOM Tables 
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c IMPLEMENTATION CONCLUSION 


Recall the goal is a dynamically extensible, flexible, consistent, and specific NVE. 
Dynamic extensibility is accomplished by using Bamboo to load and unload modules. The 
NVE is consistent because the amHLAAdmin module ensures all entity and terrain 
modules required by the designers be loaded when required. Each module 1s specific 
because the programmer is only concerned with one module representing a particular 
entity. That programmer no longer has to concern himself with the representations and 
behaviors of the other entities in the environment. Finally, all of this adds up to flexible 
environment that can be changed during runtime to the state required by the simulation 
managers. 

The preceding sections provide the overview of how the implementation 
accomplishes the goal of providing a dynamically extensible, flexible, specific and 
consistent NVE. Appendix A provides a detailed implementation tutorial that guides a 
user through the details required to implement an amEntity module. Appendix B provides 
the code examples that accompany the implementation tutorial. Together these two 
documents walk a user through the correct use of the HLA RTI, Bamboo and the 
amHLAAdmin module. 
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V. RESULTS AND LIMITATIONS 


A. PERFORMANCE RESULTS 


Two measures of performance were used to judge the merits of this 
implementation: frame rate per second and average time to clear the event buffer. Frame 
rate per second describes how the implementation impacts the graphics subsystem. Falling 
below ten frames per second severely hampers virtual environment realism. Time to clear 
buffers shows the impact of increasing numbers of entities on the system’s ability to 
update each one. Each measure was sampled with different communication reliability 


parameters, specific numbers of entities, and federates participating in the environment. 


1. Test Description 


The system used to evaluate the implementation is a Windows NT 4.0 LAN, with a 
166 MHz Pentium MMX CPU and 32 Megabytes of RAM. Each system connects to the 
100 Mbps LAN with a 3Com 10/100 Mbps network interface card through a 100 Mbps 
hub. The graphics subsystem on these systems is not accelerated. All graphics are 
computed on the system processor. There was a single federate per system. Each 
federate computed and transmitted position, orientation, and velocity data every fifth 


frame. 


Transport for Attribute Updates and 
Interactions is Either Reliable or Best-Effort 


Federation 
Execution 


Fed Ex is the RTI 1.0 exploder 


for all reliable comm: TCPAP streams 


IP Multicast 
Address 


Best-effort traffic via IP multicast 





Figure 9: HLA Message Transport Types 
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There are two communication reliability settings defined by the HLA IF Spec: 
FED_RELIABLE and RED _BEST_EFFORT. FED_RELIABLE uses the federation 
execution to ensure that each message of this type is delivered to each federate in the 
federation. This adds a significant number of messages to the network since 
acknowledgements are required to confirm’ delivery of each message. 
FED_BEST_EFFORT reduces message traffic compared to FED_RELIABLE because 
each federate transmits its messages to a multicast address where every other federate 
reads the messages. There is no requirement for acknowledgements, but there is a small 
chance that a message may be delivered improperly or not at all. Figure 9shows 
graphically the differences between FED RELIABLE and FED_BEST_EFFORT 
reliability settings. FED_ RELIABLE transport creates a bottleneck because the federation 
execution process acts as a server ensuring that all federates receive each update. The 
FED_RELIABLE transport type only allowed two federates in the federation before the 
federation execution was bottlenecked, so no further measurements were taken. Two 


federates does not make a very interesting virtual world. 


me Frame Rate Results 


Figure 10 shows the frame rate results for a federate using the 
FED_BEST_EFFORT transport protocol. Notice that the frame falls as the number of 
entities in the federation increases. This is to be expected. Each new federate brings 44 


more polygons to the virtual world. 
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Figure 10: Performance Results 


5: RTI Event Buffer Read Results 


Figure 10 shows the time to clear buffer results. The time to clear buffer is the 
time required to process all events in the RTI event queue. In this implementation all 
events are attribute updates. This test shows the average time it took to clear the event 
buffer. Recall that the reliable transport type was only able to accommodate two federates 
with a total of 22 entities in the federation, while the best effort transport type 
accommodated more than three times that with 7 federates and 77 entities. Notice that the 
average time to clear the buffer increases with the number of entities in the federation. 
This could hmit scalability, but recall the limited power of the test systems and that the 
entity module in the test does not implement dead reckoning. Dead reckoning could 


reduce the number of entity updates thus improving the time to clear the buffer. 


B. LIMITATIONS 


There are two major limitations in this implementation. The RTI limits the 
implementation due to its static nature. The design of the anHLAAdmin module is 
limited because it lacks a method of extending the executable by providing a separate 


thread to handle entity updates. 
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1. HLA/RTI Generalization 


This implementation 1s generalized except for the HLA/RTI functionality. The 
RTI limits the functionality in two ways. First, the RTI’s use of text files and environment 
variables limit the flexibility of this implementation. An API interface that set the RTI’s 
state would significantly increase the flexibility of the system. Implementation of the HLA 
functionality requires that RTI be installed on every machine it is used on. It would be 
much more flexible if the RTI could be instantiated anytime and its state set with API 
function calls. This would allow the RTI to be part of the amnHLAAdmin module and 
could be loaded in one step without having to actually install the RTI so that the static text 
files and environment variables are defined. Second, the FOM is predefined and parsed by 
the RTI at runtime. If there was an API interface to change the FOM during runtime, the 
federation could extend its capability without requiring that the federation execution be 
restarted. 


jap HLA Memory Footprint 


Each federation has three processes that must exist in order for the federation to 
operate: the RTI executive process, the federation executive, and at least one federate. 
The RTI executive process requires approximately 2.5 MB of RAM in order to run, while 
the federation executive requires 2.5 MB. Each federate’s memory requirements will 
vary, but the local RTI component, or RTI ambassador requires 12 MB. This is a total of 
17 MB required on one system. This is a significant amount of memory that must be 
considered when designing systems portable to desktop systems. 


3. amHLAAdmin Module Limitations 


The amHLAAdmin module does not provide a method for extending the 
executable. If this module provided a set of callbacks simular to the visual module’s app, 
cull, draw system, the implementation could better control the sending and receiving of 
information through the RTI. For example, a separate thread could be started that 
continuously “ticks” the RTI, thus keeping its receive buffers clear. Additionally, a 
generalized system that allows each module to register callbacks on an update loop would 
provide a more efficient method of updating entity state. These improvements were not 
made because the significance of the processing time required to update entity state was 
not discovered until the final performance tests were run. Future improvements to the 
system will require a better method of managing processor time for the RTI to update 


entity state. 
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VI. CONCLUSIONS 


A. CONCLUSION 


The implementation meets the requirements set out in the introduction concerning 
the improvements NVEs require. The requirements are the virtual environment must be 
dynamically extensible, flexible, specific, and consistent. This implementation is 
dynamically extensible. Bamboo does an excellent job of providing this capability by 
implementing the ability to dynamically extend the executable and providing a system that 
defines module dependency. The ability to load and unload modules on the command of 
the user or the system at any time during execution adds flexibility to the NVE. This 
means simulation designers can rapidly prototype simulation executions in real time and 
effectively design and implement the virtual environment. This demonstration verifies that 
simulation designers can be more specific. In other words, programmers just need to 
implement their module. They no longer need to represent the other entities that will exist 
in the NVE or approximate their behavior. An entity module that can be loaded as the 
situation changes and unloaded when no longer needed represents these remote entities. 
Finally, this system ensures that all simulations operating in the NVE are consistent with 
each other. The problem of different terrain models at each simulation site is solved 
because all sites receive the terrain module from the same location and execute it in the 


same manner. This same logic applies to the entity modules. 


B. FUTURE WORK 


The following lists future projects that could improve real time virtual 


environments. 


i: Network Bandwidth and Latency of the RTI. 


It is very difficult to quantify the effects the RTI has on the network. We do not 
know the methods used to keep the distributed local RTI components updated. What is 
the time management method employed by the RTI? How are the receive buffers filled 
and emptied? What is the most efficient method of clearing the buffers? The results 
indicate that more information is required to increase the numbers of entities modeled in a 


real time virtual environment. 
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2. Methods for Reducing Network Traffic Required to Maintain 
Consistent Entity State. 


This work refers to ways to improve the RTI for real-time simulations. Area of 
interest management is a method of accomplishing this goal. The new version of the RTI, 
version 1.3-3, has implemented its own area of interest management system call Data 
Distribution Management (DDM). Future work could entail implementing support for 
DDM into this implementation. 


3. Improvements to the Current Implementation 


There are several ways to improve this implementation. First, the amHLAAdmin 
module could implement a series of callback handlers that accomplish the entity updates 
and interactions required by the system. This improvement would make the 
implementation more general by removing the requirement for the amObject pure virtual 
Class interface. Next, multi-thread the implementation to provide specific amounts of 
processing time to the RTT and visual module. Finally, implement a system that ensures 
that locally computed objects are updated first. Currently, all entities are in the same list. 
Locally computed objects should have a separate list so they may be updated at a greater 


rate. 
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APPENDIX A: IMPLEMENTATION TUTORIAL 


A. INTRODUCTION 


This tutorial describes how to implement a module that will operate using the 
HLAAdmin implementation. It has three sections: Bamboo module implementation, HLA 
Implementation, and Demo. The Bamboo module implementation section describes how 
to build a module for use with the Bamboo virtual environment toolkit. The HLA 
implementation section outlines the HLA concepts that the user must understand to 
implement a module for the HLAAdmin implementation. Finally, the Demo section 
describes how to run the existing implementation. Taking each section in turn will ensure 


the user of an overall understanding of the HLAAdmin implementation. 


The system requirements for this implementation are, Windows NT 4.0, Visual 
C++ 5.0, RTI 1.0-3 and rktools. Visual C++ is the compiler used in the examples and 
rktools provides the functionality needed to use makefiles that are very sumuar to UNIX 
makefiles. All the RTI functionality described in this tutorial is explained in detail in the 


RTI Programmers Guide, see the bibliography in the main section of the thesis. 


B. BAMBOO MODULE IMPLEMENTATION 


The easiest way to grasp how to implement a Bamboo module 1s to use one as an 
example. I will use the amBoid module, available in the code appendix, as the example 
module. Bamboo modules are made up of a minimum of four files: module.h, module.c, 
amBoid.h, amBoid.c. (The amBoid files are examples; any name can be there.) Each 
module is identified to the Bamboo kernel by six global functions defined in the module.c 
file: getModuleName(), getModuleVersion(), getModuleDate(), getModuleText(), 
initModule() and exitModule(). As a module is loaded, Bamboo creates a bbModule 
object that holds pointers to these functions. 

When the module is loaded, the bbModule object executes the initModule() 
function. The initModule() function does the work required to add the module to the 
executable and instantiate any object required by the module. The exitModule() function 


removes the structures used to integrate the module into the executable and deallocates 
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the memory associated with any objects created for use by the module being deleted. 
Notice in the example module.c that the definition for the initModule() function makes one 
call to the initamBoid() function in amBoid.c, and the exitModule function makes one call 
to the exitamBoid() function in amBoid.c. 

The initamBoid() function does the functions described above. This function is run 
only once immediatley after the module is loaded into memory. First, it instantiates a Boid 
object for use by the module. Then it calls the initKeyboardFunc() to add callbacks for 
keyboard events. This is one way to add the module into the program execution. The 
other method is to add callbacks that will include the module’s functionality into the 
executable. This module 1s added to the executable by adding callbacks to the Visual 
module. The init VisualModule() function adds a callback to the preapp callback handler. 
The callback is associated with the preAppFunc() defined in amBoid.c. This function 
defines the keyboard controls and behavior for the Boid object created in the loadBoid() 
function. After this function is executed, the module executes as part of the Bamboo.exe 
executable until a command to unload the module. 

On the command to unload a module, the bbModule object calls the exitModule() 
function defined in the module.c file. This function in turn calls the exitamBoid() function. 
The exitamBoid() does the housekeeping required to remove from memory all structures 
like callbacks or objects related to the module. In this case, the exitamBoid() function first 
removes the event responses from the keyboard. Notice that these commands are in the 
reverse order of the commands that were used to create the keyboard events. Next the 
preapp callback is removed. Finally, all objects associated with this module are deleted 
from memory. 

The last Bamboo feature that will be discussed deals with module dependency. 
Bamboo extends the plug-in metaphor by implementing a system that allows modules to 
depend on other modules for execution. In this example, the amBoid module depends on 
the npsVisualModule, the bbKeyboardModule and the amHLAAdmin module. The 
module.txt file defines these dependencies. Bamboo ensures that all dependent modules 


are loaded first before the module that needs them is loaded. 
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This concludes the Bamboo section. It is not complicated to load and unload a 
Bamboo module. The user is required only to define the six functions in the module.c file. 
Understand that Bamboo’s greatest strength is its convention that defines generalized 
methods to load and unload modules while providing a system that ensures module 


dependencies are enforced. 


C; HLA IMPLEMENTATION SECTION 


HLA is implemented mainly in the anHLAAdmin module. Entity modules just 
make an Admin API call to pass or receive information to the RTI. There is one exception 
to this that I will address later in this section. The Admin API wraps ups all RTI 
ambassador functions. When the amHLAAdmin module loads, it instantiates a single 
object of type Admin. The entire API is static functions defined in the Admin class. 

The Admin class uses the following RTI functionality (* is a Federate Ambassador 
function): 


Federation Management 
CreateFederationExecution 
JoinFederationExecution 
ResignFederationExecution 
DestroyFederationExecution 

Declaration Management 
PublishObjectclass 
PublishInteractionClass 
SubscribeObjectClassAttributes 
SubscribeInteractionClass 

Object Management 
RequestID 
RegisterObject 
UpdateAttribute Values 
DiscoverObject* 

Reflect Attribute V alues* 
SendInteraction 
Receivelnteraction* 
DeleteObject 
RemoveObject* 

RTI Services 
Tick 
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The RTI has other functions that do not apply to this implementation like time 
management and ownership management. If this functionality is required, the Admin 
object can be extended. Refer to the Admin.c file in the code appendix for the following 
functions. Notice the Admin class constructor is protected. There can be only one 
instance of the Admin class active so a singleton is implemented called getInstance() that 
creates the object the first time it is called and returns the pointer to the object every time 
it is called. The Admin constructor instantiates the RT] ambassador (rttAmb) and the 
Federate ambassador (fedAmb) objects. The rttAmb is the predefined object that contains 
all the functionality that implements the IF Spec. The fedAmb 1s a pure virtual class that 
defines the interface between the RTI and the implementation. Each rttAmb call results in 
a return value from the RTI or, in the case of updates, a call to a fedAmb function. Let us 
discuss how the implementation uses each of the above RTI services and discuss the code 


that implements the service. 


A. Federation Management 


The Admin constructor shown in Admin.c. makes calls to 
Admin::createFederationExecution() and Admin::joinFederation(). The 
createFederationExecution() function calls Admin::rttAmb- 
>createFederationExecution(fedExecName) and passes it a char* that defines the name of 
the Federation execution. If the federation already exists, the rttAmb throws a federation 
already exists exception. If the federation is new, then a fedex process 1s spawned by the 
RTI. The Admin::rtiAmb->joinFederationExecution(federateName, fedExecName, 
fedAmb) passes it the name of the federate, the federation execution name and a reference 
to the fedAmb object. The name of the federate is name mangled by the RTI so it does 
not have to be unique and the fedExecName must be the same as was used 1n the 
createFederationExecution() function. The fedAmb reference is a pointer to the fedAmb 
created in the Admin constructor. The loop is used to give to the federate multiple tries to 
join the federation because the federation execution may require more time to configure 


itself before it is able to return the federate ID. The federateID is a unique number 
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assigned by the fedex that identifies your federate. It is not required anywhere but may be 
required by the user. 

The Admin::resignFederate() function handles the resign federate and destroy 
federate management functions. This function first calls Admin::rtiAmb- 
>resignFederation() and passes an enumeration that defines the clean up the user wants 
done prior to federate resignation. The implementation uses 
DELETE_OBJECTS_AND_RELEASE ATTRIBUTES. This value results in 
removeObject() calls to the fedAmb for all locally updated entities and releases the 
attributes on any objects that must transfer attribute ownership because the federate is 
resigning. The final call in this function is to the Admin::rtiAmb->destroyFederation(). 
This function destroys the federation if there are no other federates operating, otherwise 


an exception is thrown and the federation continues. 


2. Declaration Management 


Declaration Management identifies to the rtiAmb all the objects/interactions and 
attributes/parameters that the federate is interested in. After the federate is joined, the 
user must get from the rttAmb the enumerated values for the objects/interactions and 
attributes/parameters computed when the FOM was parsed. The Admin::Init() function 
uses RTI support functions that use the information from the FOM to provide these 
enumerated values for the different objects/interactions and attributes/parameters. Notice 
the Init() function uses specific functions that provide the enumerated values for the 
different Objects (getObjectClassHandle(char *)) and Attributes 
(getAttributeHandle(ObjectT ypeEnum,char *)) that will be used by the federate. The char 
* parameter must match exactly with the strings used to describe the Objects and 
Attributes in the FOM. 

After the enumerated values are saved by the user using the Init() function, the 
user calls the Admin::PublishAndSubscribe() function. This function makes RTI calls that 
tell the rtiAmb which Objects/Interactions and Attributes/Parameters the federate will 
publish and subscribe. The mechanics of this operation begin with the user building an 


RTI::AtrributeHandleSet. This data structure holds the attribute enumerations for a 
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specific object. The first part of the PublishAndSubscribe() function builds the 
RTT::AtrributeHandleSet. First the set 1s declared. Then space 1s allocated for five 
attributes using the create method of the RTI::HandleSetFactory object. Finally, all 
attributes that the federate wants are added to the set using the add(AttributeHandle) 
method and passed the enumeration for the specific attribute to be added. After all the 
attributes are added to the HandleSet the Admin::ms_rtiAmb- 
>subscribeObjectClassAttribute( ClassHandle, *HandleSetFactory ) and 
Admin::ms_rtiAmb->publishObjectClass(ClassHandle, *HandleSetFactory) are called to 
tell the rtiAmb those objects that will be published and subscribed. The last functions are 
for subscribing and publishing Interactions. Notice that these functions do not require a 
HandleSetFactory. When a federate subscribes or publishes an interaction, it accepts 
responsibility for all the parameters of that interaction, hence there is no need to tell the 
rtiAmb which parameters it is responsible for. 

The above functions accomplish all the tasks required to publish and subscribe to 
objects/interactions and attributes/parameters. These are required tasks that all federates 


must accomplish in order to participate in the federation. 


3: Object Management 


Object management services provide the functionality to identify entities to the 
RTI, discover them on remote federates, and update their attributes during the federation 
execution. The RTI requires that all entities are associated with an Object defined in the 
FOM. All entities must possess a unique ID number provided by the RTI. This number 
identifies the entity on all federates in the federation and ensures updates and interactions 
are processed on the correct entity. 

The first task when adding an entity to the federation is getting its ObjectId from 
the rtiAmb then registering that ID with the rtiAmb. The Admin::registerObject() function 
accomplishes these tasks. First the Admin::ms_rtiAmb->requestID(RTI::ObjectIDCount, 
RTI::ObjectId, RTI::ObjectId ) function provides the ObjectID numbers. Then the 
Admin::ms_rtiAmb->registerObject( RTI::ClassHandle, RTI::ObjectId ) function registers 
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the entity with the rttAmb and associates it with a Object that was previously published or 
subcribed. 

After the object is registered with the rtiAmb, the entity will be updated and its 
attributes reflected on all participating federates. This task requires that the entity be 
discovered by each federate in the federation. Discovery requires that the entity be 
updated at least once. On the first update, the rtiAmb calls the 
FederateAmbassador::discoverObject() function. This function then ensures the module is 
loaded that represents this object. After the module is loaded an entity is instanced and its 
State is updated with the attributes passed by the rtiAmb. Refer to the 
AdminFederateAmbassador.c file for the discoverObject() function. After the object is 
discovered, all updates come to it through the 
FederateAmbassador::reflectAttribute Values() function. We wul look at how the 
attributes are updated first. Then we will look at the discoverObject() function 1s detail. 

Entities are updated using the rtiAmb->updateAttribute Values() function. The 
implementation calls this function in the Admin::sendEntityUpdate(RTI::ObjectID , 
RTI::AttributeHandle ValuePairSet& , const RTI::UserSuppliedTag ). Each entity must 
implement the virtual function sendUpdates() defined in amObject. This function 
produces a RTI::HandleValuePairSet then calls the Admin::sendEntityUpdates() function. 
Refer to boid.c in the code appendix for listings of entity functions. Boid::sendUpdates() 
first creates a Handle ValuePairSet with the attributes in it that it wants to update. Then it 
calls Admin::sendEntityUpdate() and passes it the ObjectId of the entity to be updated, its 
Handle ValuePairSet and the UserSuppliedTag which identifies the module that the entity 
is modeled by. Admin::sendEntityUpdates() then calls the Admin::rttAmb-> 
updateAttribute Values( ObjectId, Handle ValuePairSet, FederationTime, 
UserSuppliedTag( ). This command sends a packet out on the network containing the 
data specified. When a remote federate receives the data the rttAmb calls the 
FederateAmbassador::discoverObject() function if the ObjectId is not known to the 
federate or the FederateAmbassador::reflect Attribute Values() function if the entity already 


exists in that federate. 
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The AdminFederateAmbassador:: reflectAttribute Values() function calls the 
Admin::receive Update() function. This function searches the list of entities and then calls 
the Boid::receiveUpdates() virtual function defined by the amObject class. The 
Boid::receive Updates() function decodes the Handle ValuePair using the get Value() 
method and updates the appropriate state variable. It then deletes the Handle ValueParr. 

If the entity is not known, the rtiAmb calls the FederateAmbassador 
::discoverObject() function. This function ensures the appropriate module is loaded then 
calls Admin::addSimEntity() to ensure the entity is added to the list of entities displayed by 
the federate. On the next update, the entity’s state is updated using the previously 
described process. 

The process for interactions is very similar. An entity generates an interaction and 
uses its Boid::sendInteraction() function. This function calls the Admin::rttAmb- 
>sendInteraction() function. This provides more flexibility to the federate. The 
interaction is received on the remote federates and the rtiAmb calls 
FederateAmbassador::receiveInteraction() function. This function then calls the 
Admin::receiveInteraction() function which finds the affected entity and calls the 
Boid::receiveInteraction() function. In this function the parameters changed by the 
interaction are modified and the ParameterHandle ValueSet is deleted. 

This implementation also has the ability to delete entities from the federation. This 
is accomplished using the RTI functions deleteObject and removeObject. When an entity 
is identified for deletion, the entity is deleted locally then the rtiAmb is notified of the 
deletion through the deleteObject function. This causes a network message that results in 
the remote federate rtiAmbs calling the FederateAmbassador::removeObject() function. 
The details follow for this implementation. First an entity identified for deletion and its 
geometry are deleted from the local environment. Then the Admin::removeAmObject() 
function is called. This function removes the entity from the object list and calls 
Admin::rtiAmb->deleteObject() which results in a call to the 
Federate Ambassador::removeObject() function. This function then calls the 


Admin::remove AmObject() on the remote federate. This process notifies the federation of 
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the entities to be deleted and makes the calls necessary to remove the entity from the 


object lists in all federates. 


4. RTI Services 


The final topic concerns how the rtiAmb is allocated processing time. The RTI is a 
single threaded application, so processing time 1s allocated through the use of the tick() 
command. This command causes the rttAmb to accomplish tasks such as clearing buffers 
and executing callbacks based on the status of the federation. 

The tick() function has two forms. The form used in the implementation ticks the 
rtiAmb once for each call. The other form , tick(min,max), will tick the rttAmb for a 
specific length of time. Both forms return a boolean value indicating if there are more 
events in the queue. This function must be run periodically in order for the federation to 
operate. Waiting too long to tick can result in overfull buffers that take an inordinate 
amount of time to clear thus reducing the overall speed of the federation. In this 
implementation the rtiAmb is ticked once per frame to provide the most updated 


information to each federate. 


D. DEMO INSTRUCTIONS 


“* Start the RTI executive. 
«* Open two command windows. 
** In both command windows, change directory to the bamboo directory. 
“* Type bamboo amHLAAdmin in both windows. 
> CTRL-E exits amHLAAdmin ( mouse must be in the execution window ) 
> The federation execution (fedex) should have started in another window 
>» There should be two light green windows ( move the top one to see the other ) 
** Now add modules to the federation. 
>» Add the Arena Terrain. 
« Type CTRL-L to load module. 
« Enter the module name  amdArena. 
= Type CTRL-T to promulgate the module to all federates. 


«* Now populate the environment. 


4] 


VW 


Type CTRL-L to load module. 


Enter the module name amBoid. 


WV 


WV 


Type B to create the Boid. 

= Control the boid with the arrow keys. 

» The A key makes it go forward. 

» The S key makes it go backward. 

Do the above in both windows. 

> Turn the boid that you can the other in both windows. 

>» Collide one boid with the other. 

» This produces an interaction. 

» After 10 hits the boid is destroyed and should disappear. 


= To add another boid type B again. 
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APPENDIX B: IMPLEMENTATION CODE LISTINGS 


Table of Contents for the Code Listings 
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amHLAAdmin Files 


fi SOSH SHS SHSHSESTSEHEHO SHH H HHH |eHSH eee SHesseSSeeesevesesseeaseeeeaeteaeas 


ey EXECUTIVE SUMMARY 

f/ 

// File Name: module.h 

4/ 

// Author: CPT Stewart Liles, Naval Postgraduate School 

3 

‘/ Description: This file defines the global functions required by 
if every dynamically-linked library. How these functions are 

ry implemented is arbitrary. but 2.t as useful have RCS 

; automate some of the work. 


' September 1998. Masters Thesis 


SHSSSCSHSSHSEHTHSO Ss SSSSHSSSSeSeeeseeeeFeeeeeseseseseeeeseeneaeseeeenes 


e.fndef _ module 
“define _ module 


6 SSH SSEHESHTSSHSSEHSEHEHESEHESHTHH SH HSHEHHOHSHSHSHESHSHSHHEHEEHHEHHESEHEHEHOTHEHEHEHE EH HEHEHE 


/ FUNCTION PROTOTYPE SPECIFICATIONS 


SSSSSSSHSSSHEHSSEHSSHSSHEHSHEHHSHEHEHEHTHHSEHTEHEHEHSHEHEH OHHH HOHSOHSHHOHSHEHHEHEHEHEHEHEHEHEEEE 


“ifdef _ cplusplus 
extern °C° { 
tendi£ 


SIM_API const char *getModuleName ()}: 
SIM_LAPI float getModuleVersion(); 
SIM_API const char *getModuleDate(); 
SIM_API const char *getModuleText(); 
SIM_AP? bool initModule(): 

SIM_API bool exitModule({); 


s.fdef _ cplusplus 
ue 
fendif 


tendif // _ module 


This is the cext from the modurie txt file 


Bambool] Ob 

4 

npsVisualModule 

bb¥ eyboardModul- 
npsFlyingCamer aModule 
anPageModule 


Bes SOSSSH HOS SSHSSHHSHSSSHSHSHESHHEHSEHTHEHTHHSEHSHEHHTSEHSSHHESHEHTEHBESHE SESH H SHH EBT ESHESE 


// EXECUTIVE SUMMARY 


// 

// File Name: module.c 

// 

// Author: CPT Stewart Liles. Naval Postgraduate School 

DE 

// Description This file defines the global functions required by 
‘/ every dynamically-linked library. How these functions are 
ff} implemented 1s arbitrary. but 1t is useful have RCS 

// automate some of the work. 

Le 


// September 1998, Masters Thesis 


4/ SOSCSSSeS SSS SSF FSSesF eee eseeest ease eHereteenetensstsetensteaeseeretstanaeease 


4/ SSSHOS SS SSHHSSHSSSHEHSSHEHSSHESSEHSEHEHEHEHEHEHEHEHESHEHESESHESEHESEHEHESEESEEHOHEEHEHEEHEEEEH HE 


f/f INCLUDES AND EXTERNS 


ff Se ee eeeeeereteccccccccscsecseccccccccssse sess eressesesseseseresserese 


#include «<stdlab.h> // atof 
fanclude °module.h°* 
include *amHLAAdmin.h* 


ee SSSOSHTSHHSSHSSESSHEHESEHEHSSEHEHESHHEHEHEHEHSHHEHHEHEHSHSHEHESHEEHHEHEHSHEHEHEHEEHHHHEHEHE HEHEHE 


Wis. CODE 


Le @enereeeeeeneeee eee eseeeeeeee ee See Geese tteeeeeetsesseeseeoeeHeteetee ee 


const char *getModuleName [) 
{ 
return *amHLAAdmin’, 
) 


float getModuleVersion() 
{ 
return 1.0; 
} 


const char *getModuleDate() 
{ 
return "1998/08/01 06:05:48°. 
) 


const char *getModuleText (} 
{ 
return °amHLAAdmin Module -- CNTL-E to exit’; 
) 


bool initModule[) 
{ 
initAdmin({); 
return 1; 
} 


bool exitModule() 
{ 
exitAdmin(); 
return 1; 
) 


eee er eee eee eeeeese eee eee sees eeeeeeserteeeeneGeseOeeeneesneeseeeseeeenos 


EXECUTIVE SUMMARY 
File Name amHLAAdmin h 
author CPT Stewart Liles Naval Postgraduate Schoo! 
Description Defines the modu.se controls for the amHLAAdmin modu.e 


September 1998 Masters Thesis 


eeereseseeeee Geese teee esos eeeee eee eee eeee see etoseetenereeeestseeteeene 


®if€ndet _amHLAAdmin 
tadefine _amHLAAdmin 


Sete eeseert eGeeseteeStee ees eSSFeoseSSSSeeeFFSeeseSFeeeereeseeeteeeree ee 


‘ INCLUDES AND EXTERNS 


, @e@ Pee eee eeeesteeteeeteneteeeesteeeeeeeeeeesxteeeeeeeeeeeeeeeeseeeeeeees 


include *admin.h°* 


Serre eteeesetsteeees settee seseeeeeeeeeeeeeeeeeeeeeeeeetseeeeeeeeeeeene 


FUNCTION PROTOTYPE SPECIFICATIONS 


SCOP ee esses eee sees eee TFFTSSOSSSSSSSSeHHeFserwTseeresetesaseeesereaeeseee 


void initAdmin(), 


void exitaAdmin(). 


Bs INLINED MEMBER FUNCTIONS 


if @@CSCSSCSCSHO SBF eeesteZF ee eeeeHeteeeeeteeeeeSSSSeseH#sSesSessesseeeeeeseeseseeeee 


Wendif // _bbHLAAdmin 


ewooeeeeeeeeteteeseeteeeee: e821 eeee= ee eee eeteeeeeeeseeeeeeeeee eee 


EXECUTIVE SUMMARY 
File Name amHLAAdmin c 
Author CPT Stewart Liies Naval Postgraduate School 


Description Oetines the moduie controls for the amHLAAdmin modu.e 
This module manages the communication between fecerates and 
nas data Structures avilanle to facil.te collision detection 
and other tasks chat require comparis un «eth a.] other 
Simulation entities 


septenper 1998 Masters Thesis 


CROSSES SHTSESTEHT TT SSHSHESETSES SHES HEHEHE HH HEHSHHEOSEHEHEHS HOHE SHEHEHHEHE SOHO HE EH OEE 


Coe eee SSeS OFFS SFeeSSeeesseF FSH eeeeeseeseseeseseeSSseeeeeeeooee 


INCLUDES AND EXTERNS 


SOSH SHTSSSEHTSTSHESESHESEHHETSEHOSHHSTHHSEHTERD ETE B BEEBE OSH OH EHSHHO BME eereeeeeees 


include °Rti hh° 
Ninclude °amHLAAdmin h° 
Minclude *bbKeyboard h* 
Winclude *bbEventResponse h° 
Minclude “bbCallback h° 
Menclude *“bbModule h* 
Ninclude “admin h° 
Sinclude “*npsWindow h°* 
"include °npsViewport h°* 
Winclude °npsCamera h* 
minclude °npsVisual h° 
finclude °*bbMouse h° 
Aunclude *amObject h°* 
include *ace/OS h°* 
Wsnclude <math.h> 
winclude <GL/gl h> 


aifdef SGI 


#include *bbSGI h° 


sendif 


SPSS SSSSHRSSSSSSHSSSHSHSHSHHSHSHSSHEHESEHEHTHESEHE SHES HESEHEHEEHESESEHESEEEEHEEEHEESEEEEEEE 


CODE 


SCG e Sees eeseeeeeeseeseeese ee Sette tteeesesseeseesesteeeeteneeteetvens 


Sees eee eee eset eee eSeSFSSSFoSSSeeeFeesesSSSFFSSSSGoeesesSSS SHE sseseose 


Function Name initadmint) 
Task Makes initial calls to make module a part of the executable 
Return Value void 


wees estes eseeseteseseeeeeeeeeeseee et eFoeteetseteseeeeseseeeneee en 


vold aimitAdmin() { 


void inicDisplayWindow!). 
void initKeyboardModule(), 
void createMainCallbackHandler(), 


Admin: .getInstance(); 





createMainCallbackHandler(); 
initKeyboardModulet{); 
initDisplaywWindow(); 


}// end inrtaAdmin 


ff @eeteeeteesseesteesteeeeeesesestesesseseseeeeeeeserseesesesnesesesarene 


// Panction Name exitAdmin({) 
// Task: deletes callbacks ete to ensure the module 1s unloaded 
ii gracefully 


// Return Value void 


ee SSC SHSSHEHSSHTSHHSESEHHEHEHESHEHS OH SHEHSHESHSHTESHEHSHS HEHEHE HTHHSHHSHHSHHHHEHEHEHEHTHSHEHEHHEOEE 


void exitAdmin() { 
bbCallback* callback: 
bbEventResponse* eventResponse, 
bbCallbackHandler*® callbackHandler; 


Admin: :getMutex(})->acquirei(); 

// delete keyboard callbacks 

// exit key 

eventResponse = bbEventResponse. findObject ( °amHLAAdminER_Exit’); 
callback = bbCallback:: findObject {*amHLAAdmin_Exit?): 

event Response->removeCallback (callback). 

delece callback, 


// resign federate 
Admin: resignFederate (); 


/¢ delete Admin instance 
admin* tmp = Admin: :getInstance!). 
delete tmp; 


Admin: -getMutex()->release(); 


exit(do); 


Pf SMS SASS Se OOOOH EAHHE 62:6 64.4: 649F COS EN THO C000 4 EO 200166640008 ON EHO OO 


// Ranction Name: initdisplaywWindow!) 

// Task inmits main window for the federate. Bamboo currently only 
tf allows on window open at time. This is the window for the 

// federace 

// Return Value: void 


ae *eeeeetoneoe teen eveeteaee eee ee eee eeee ee eee eeeeeeeeeeeeteeeeeeaeeeeeeae ee 
void initDisplaywindow() { 


void preDrawFuncibbObject ‘object, bbData ‘data): 


npsWindow “window; 





npsCamera *camera; 

npsViewport *viewport; 
apsVec3f£ position; 
bbCallback *callback; 


bbCallbackHandler ‘callbackHandler; 


//eoreate the window for the simulation 

window = new npsWindow(370,. 370). 
window-> setName (*AdminWindow®*); 

viewport = new npsViewport(0.0f. 1.0f. 0.0f. 1.0£). 
viewport->setName (*AdminViewport’}. 


// Camera to view the area 

camera = new npsCamera(); 

camera->setName (*AdminCamera®). 
camera->setFarClip(200.0£)., 

position.set(0.0£. 3.0£, 10.0£); 
camera->setPosition(position); 
camera->setClearColor(0.66f. 1.0f. 0.66£. 1.0£). 
camera->setAspectMode(npsCamera. :CALC_VERT) : 
Vlewport ->setCamera (camera); 


window->addViewport (viewport); 


// callback to change position of camera and update screen 
callback = npsV:zsual: :drawCallback(), 

callbackHandler = callback->getPreCallbackHandler(). 
callback = new bbCallback(), 

callback->setName (°amHLAAdmin_preDraw*), 

callback->setFunc (preDrawFunc). 
cailbackHandler->addCailbackLast (callback): 


\/f/snredisplaywWindow 


Heb 
// 
ff 
tf 
// 


Sees Se SS SSSSSSSHSSSSSSSSSSSFFeeeseseetseeeeeeseteteeeeseeseeeaese 


Function Name preDrawFunc(} 
Task calls Admin::display to update simulation entities 
Return Value: void 


void preDrawFune (bbOb3ect *ob3ect,. bbData *data) ( 


admin: getInstance()->display(}: 


}// end preDrawFunc 


ff 
aed 
ff 
‘¢ 
it 
ff 


/ 


SSOSSHSSSSHHSHHHHEHSSHEHSSSESEHTSEHEHESEHEHSEOHEHH HS SHEHEHHOHEHEHEHESEHHESHESEHEHEHOHEHEHEHE HEEB EEE 


Function Name. createMainCal lbackHandler {) 

Task puts callback on the bamboo main event loop. this is done 
vecause RTE 1.0-3 reqiires that the RTI be ticked from the 
same thread that instantiated it 

Return Value void 


SCTE SHTSHSEHESOSHHESESSSSSSHHSSHHHOHSHEHSHEHTSHEHEHEHTEHEHT EHH H OR HEHH HEHEHE HDHEHHEOHE 


ee ne  . *="= 2 


tresteMainCcal lbackHandier 

2 AlaTieckRTI (bbubyect cunjyect bbData “data 
eallback. 

callosckHandler 


bbCallbacke 

bbC al lbackHandler® 
-allbacmHandier - bbCallbsckMandler f{indObject:°ma.i -allbackHandier” 
ealtibark - new bbCallback (} 

callback->setName °rtaTick®?), 

tallback->setFuncihlaTickRTI) 

‘alibackHandler->addCallbackLa:t (callback. 


end createMainCalilbackHand.er 


COO OSSSHHHS SESE SSHSOSEHHESESSHEHOESSHSSHHSHSEHSHHSEOHSHEHT OSE HEEHHOHEHEHEHEHH OBE 


Function Name initKeyboardModule 
Tas« creates module keyboard callbacks 
Return Value void 


eer eeee eet eee troeeseee eer es eeeeeeeeseseeeeeetaeertaasetasreesteeeetaate 


void anitKeyboardModule\ { 


void exitFune(bbObject “object. bbData *datal, 

void hlaUpdateBoidibbObyect ‘object, bbData “data). 
void AlaTickRTI (bbObsect cobject, BbboData “edatal, 

void hlaUpdateObject (bbObj ect *obyect bboData *datal. 
void hlaUpdateClass{bbObjyect *object, bbData ‘data 


bbKeyboard *keyboard, 
bbEvent Response eeventResponse, 
bbCal lback *ca.)] back; 


ge: the keyboard device 
keyboard = bbKeyboard getInstancei). 


set up exit key 
eventResponse = new 
bbEvent Response (boKeyboard KEY_E | bbKeyboard ‘CTRL MASK 
bbKeyboard ‘DOWN_TRANS) , 
eventResponse->setName { “amHLAAdminER_ Exit’), 
callback = new bbCallback(). 
callback->setName (°amHLAAdmin_Exit?) ; 
¢allback->setFunc(exitFune), 
event Response->addCal lbackLast (callback) ; 
keyboard->addEvent Response (eventResponse) : 


rend initKeyboardModule(} 


eoereee eter eset reeset eeeee ee eaeeeeeeeeseeaeeeeseeneeeeeseeteseeeeeae 


Function Name exitFune 

Task eallbck function for cntrl-e that exits the federation and 
ensures all callbacks are cleaned up 

Return Value: void 


ereeeeeeeeeewee ee teeeeeeseeeebeeeseeeseeeeeseese ete eteoeeaeeeaaeeane 


y = bbMouse .getY{): 
boScreen: :normalizeVal(&x, by); 


if (viewport->getWindow()->1sValinside(x, y) ) ( 
flage=— 1 
) 
return flag: 
)// end mouseInwWindow() 


// end amHLAAdmin.¢ 


void exaitFune bbObyect ‘sbject 


Ve 


bbData “data 
int mouseInWindow 


bboModule *module. 


if {mouseInwindow(! |! 


module boModule 93 findObject ‘*amHLAAdmin?®) 

1f& {*module) ( 
cout << ‘amHLAAdmin 15 not currently loaded egne: ing’ << endl. 
return, 

\//and if 


af ['bbModule unload module) } ( 
cout << ° Error unloading amHLAAdmin * << endl, 
cout << * Fatal Error - aborting executable'*® << endl <«< endl, 
ex.t'd), 
pee “end if 
| fand raf 


exitfFunc, 


Seeeeesceeeesteeeert eee ee aeeeaeeeeeeeeeeteaeeeeeseeeeeeeeaeeeeseesesn 


Function Name. hlaTickRTI 

Task: Callback func chat makes the RTI calls that tack the rts 
this provides the cpu time for the rti to get 1%s wors done 

Return Value void 


Seteseeeeeseeseeeeeeteseeeeeeeweeeseeeeeeseeseeseeeeteeeetereaeereeareee 


void hlaTickRTI (bbObj ect “object. bbData *data) ( 


Dah 


ied 
ae 
4/ 
eh 
ff? 
nF 


RTI :FederationTime tmpTime(i 0); 

while (Admin. getInstance!)->tickRTI(3), 

Admin: .getInstance() ->updateFederation(tmpTime) , 
end hlaTickRTI(} 


Seeeeeeseeee eee ee sees se Seeeeeeeeteeseteeeseeeeeeeeeeeeeetseaeaeeeesee 


Function Name: mouselInwWindow 


Task: ensures the mouse pointer is the window that you want to 
update 
Peturn Value integer that 1s interpreted for use as a bool 


eeceetoeeeeeeteeew se eee seeteeeeeeeeeseeeeeee ee ee eeeseeeeSeeseeesrereanee 


unt mouseInWindow() { 


// 
tf 
ee 
Adi 
i 4/ 
es 
Lh 
hh 
4/ 
i ide 
of 
Ae, 
4/ 


ant flag = 0; 


npsWindow *window, 

apsViewport “viewport; 

window = npsWindow: - findObyect (°AdminWindow®) , 
viewport = npsViewport: -findObjyect (°AdminViewport’), 
float x.y: 

x = boMouse ‘getXi]; 


SSSSSSSHS SSS SEH HESHSSSSHHSH SHEETS SSEHSHESSEHEHTOSTHESEHESHEHESHEHEHHEHHOHSCHEEHTHESCEHEEEE 


EXECUTIVE SUMMARY 
File Name: admin.h 
Author: CPT Stewart Liles, Naval Postgraduate School 
Deseription: Definition of Admin class 

This file defines the utility and external API functions 


required to manage an amCompatible federate 


September 1998. Masters Thesis 


eeoeeeoeoeeeeeeeeeeereeeebeoeoeeeeeeeeeeeseeoees ee eeeeeeeeereeevreeaeeeeeeeenenee 


®inelude "Rti. hh” 

®include °AdminFederateAmbassador.h” 
Winclude °npsVec3f.h° 

#include "“npsGeometry.h° 

#include "“bbKeyboard h°* 

Winclude “amObject.h° 


ifndef _admin 
#tdefine admin 


//defines 


“ifndef SIM_API 
#ifdef VISUALCPP 


ndefine SIM_API __declspeci(dllimport) 


selse 


adefine SIM_API 


sendif 
sendif 


class SIM_API Admin 


( 


//member variables 
public: 


// Simulation Entity data memebers 
static vector<amObyect*> ms_amObjectArray; 
static unsigned int ms_NumberAmObjects; 


f/ Array of Dbjyects used by modules 
static vector<amObject*> ms_ModuleaArray; 
static unsigned int ms_NumberModules; 


4/ The Terrain Object pointer 
static amObject* ms_Terrain; 


// time management variables 
static RTI: :Boolean ms_timeAdvGrant; 
static RTI: :FederationTame ms_grantTime. 





static RTI Federat:-aTime Tasast Time 
mucex ..ed : make Adm.- Thresac Sate 
RTI Ambassador pointes sati.c ACE_Recursive_Thread_Mutex adminMutex 
static RTI RTIsambassador” ms_rtiaAmb 
member functions 
static RTI FederateHandis m federatelD public 
‘? destructor 
virtua, -Admin 
tlag that signals whether interactions are valid 
static RTI Boolean ms_inzeractionFlag, ‘ ensures update of the federation 
woad updateFederation(RTI FederationT.mes newTime 
‘! mame of the Federation Sxecution 


statie char® const m_FedExecName. This 1s the Admin API portion 
é provides url cto module locations singleton getter 
static char’ const ms_ModuleURL, -Tatec Admin *getInstancel). 


+ end data to RTI 
static void sendColiisioniInteracti:on'RTI FederationTime theTime 


private RTI ObjyectID oid 
/, Static Member Data 
(/ Federate Ambassador Pointer static void sendEntityUpdate (RTI: Object ID theObject 
static AdminFederateAmbassador® ms_fedaAmb, RTI AttributeHandleValuePalrSets theAtiributes, 
const RTI UserSuppliedTag theTag!., 
‘/ RTPI data provided by the RTI during Init 
static RTI ObjectClassHandle ms_AdminClassHandle. / Receive data from RTI 
static RTI AttributeHandle ms_ModuleURLAttrHandle, static void receiveUpdate;: RTI ObjectID theObject. 
static RTI AttributeHandle ms_ModuleVersionAttrHandle, const RTI AttributeHandleValuePairSets’ theActributes. 
static RTI: AttrabuteHandle ms_ModuleNameaAttrHandie, RTI: FederationTime theTime. 
const RTI UserSuppliedTag theTag. 
static RTI: -ObjectClassHandle ms_ESClassHandle RTI: : EventRetractionHandie theHandle |: 
static RTI: AtctributeHandle ms_PositionAttrHandle, 
static RTI. AttributeHandle ms_Orlentat:onattrHandle, static void receivelnteraction(RTI InteractionCiassHandle 
static RTI AttributeHandle ms_VelocityaAttrHandle, theInte#raction. 
static RTI AttributeHandle ms_AmmunitionAttrHandle, const RTI ParameterkandleValuePairSet& theParameters. 
static RTI. .AttributeHandle ms_DamageAttrHandle, RTI .FederationTime theTime. 
const RTI UserSuppliedTag theTag. 
static RTI. :InteractionClassHandle ms_Collis:oniInteractionHandle, RTI: EventRetractionHKandle theHandle), 
static RTI ParameterHandle ms_EntityIdHandle, 


+ Manage Sim Meity Pointers 
static void display({): 


// Names for querying RTTI values static void addModuleFunctionPointerlamObject*), 
static amObject° findSamEntity(RTL.:ObjectID objectiId }. 
static char® const ms_ESClassSt:, static amObject* findSimEntity(const chars ° moduleName, ; 
static char* const ms_PositionStr. static RTI: :ObjectID registerObjectt): 
static char’ const ms_OrientationStr, static amObject* addSimMtity(const char’ moduleName. RTI ObjectID!. 
static char*® const ms_VelocityStr, static amObject* checkEntatyCollision(amObject* that), 
static char’ const ms_AmmunitionStr, static void removeAmObject (RTI: .ObzectID oid); 
static char® const ms_DamageStr; 
static char® const ms_CollisioniInteractionStr; ¢/ Module Object Management 
static char* const ms_EntatyldStr; static RTI.-Boolean moduleLoadedi(const char’ moduleName, ; 
static void loadModule{const char’ moduleName) ; 
‘/ constructor is private due to singleton static void unloadModule(const char* moduleName}. 
Admini); static amObject® findModule{const char’ moduleName). 


static void removeModulei(const char’ moduleName). 


//{ singleton 
static Admin °’this_, // RTI execution management 





static RTI: :Boolean tickRTI(); LF LLLL SALLE LASS AGEL LL LOD OEE ARSE SSS OS SSCL SSS SS 2 282 0092 2 012'0 0:2 2) 2)2 22 
static RTI: :Boolean tackRTI(RTI: -TackTime manTick,. RTI: .TackTime maxTack) ; ff EXECUTIVE SUMMARY 
static void advanceTime(RTI.:FederationTime time) ; // 
static vold resignFederate({), // File Name. admin.c 
static void joinFederation({), ff 
static void setTimeManagement (} ; // Author. CPT Stewart Liles. Naval Postgraduate School 
static void createFederationExecution(); LY 
static void Inve i // Description: Method Definitions of Admin class 
static void PublishAndSubscribe(); tf This file defines the utility and external API functions 
static ACE_Recursive_Thread Mutex® getMutex(); LL required to manage an amCompatible federate 
f/ 
| // September 1998, Masters Thesis 
pF Accessor Methods J/ ereeeereeeeenaeeeeeoeseeeresreseeeereeeeeeeeeeereeaerereereeereTeaBVesee 
// Static Accessor Methods I include °RTI.hh° 
Wanclude “admin.h’* 
static RTI: :ObjectClassHandle getESClassHandle(} include *AdminFederateAmbassador.h°* 
{ return ms_ESClassHandle; }; Winclude °npsGeometry.h° 

static RTI: .AttributeHandle getPositionaAttrHandle()} Winclude *bbKeyboard.h* 

{ return ms_PositionAttrHandle; }; Winclude *bbModule.h°* 
static RTI: .AttributeHandle getOrientationAttrHandle(} I Winclude “amObject.h* 

{ return ms_OrientationAttrHandle; }; #include °ace/OS.h* 
static RTI: -ActributeHandle getVelocityAttrHandle() Winclude °vector.h* 

{ return ms_VelocityAttrHandle; }; 
static RTI: -AttributeHandle getAmmunitronAttrHandle(} 

{ return ms_AmmunitionAttrHandle; ); // Static Variable ianitialazations 
static RTI: :AttributeHandle getDamageAttrHandle({) 

( return ms_DamageaAttrHandle, ); // singleton 


Admin *Admin.:this_ = 0; 


static RTI: :InteractionClassHandle getCollisionInteractionHandle() 
(return ms_CollisionInteractionHandle, ) RTI: :RTIambassador°? Admin: :ms_rtiAmb = NULL. 


H 


static RTI: :AttributeHandle getEntityIdHandle(} AdminFederateAmbassador® Admin: -ms_fedAmb NULL. 


{ return ms_EntityIdHandle, }; 
RTI: : FederateHandle Admin: :m_federateID = 0, 


}: // end Class Admin { vector<amObject *> Admin: :ms_amObjectArvray; 
tendif i 
| unsigned int Admin: .ms_NumberAmObjects = 0, 
vector<amObj,ect*> Admain::ms_ModuleaArray: 
! 
unsigned int Admin: :ms_NumberModules = 0; 


amObject*® Admin: :ms_Terrain = NULL: 


//Time Management flags 


RTI: : Boolean Admin: :ms_timeAdvGrant = RTI: :RTI_LFALSE; 
RTI: :FederationTime Admin: :ms_grantTime (1.0); 
RTI: :FederationTime Admin: :m_lastTime, 


RTI: :Boolean Admin::ms_Interact:ionFlag = RTI.:RTI_FALSE: 
// RTYTI data 
| 


RTI Ybyect. lassHandle Adm. ms ES lLassHandle 


RTI AttributeHandle Admit ms PesitionAttrHan tle 
RTI AttributeHandia Admin Mms_vrientationAtt rHandle 0 
RTI AttrsbuteHandie Ainin ms_VelocityAttrHandle - 0, 
RTI Att ributeHandie Admin #s_AmmunitionAttrHandle = 0, 
RTI AttributeHandle Admin ms DamageaAttrHandle = 0. 
RTI InteractionClassHandie Admin ms _CoclisioninteractionHandi-= 
RTI ParameterHandle Admin ms_EntityldHandle - 0 
Names for querying RTTI values 

char* const Admin oms EsclassStr *“EntityState =; 
ehar® const Admin ms_PositionsStr = *Position®, 
char” const Admin ms _ %riertataionStr = “VUrientation®, 
¢har® const Admin ms NelscityStr = °Veloerty”®, 
echas* cons: Admin oms AmmunitionStr = °Ammunition®, 
char® const Admin ms_DamageStr = *Damage°, 
echar® const Admin ms_CollisioniInteractionStr - "Collision®. 
char’ const Admin ms_EntityrdStr - °EnetatyId°. 
char’ const Admin m_FedExecName = *HLA_Admin*, 
echar® const Admin ms_ModuleURL = °URL not detined’, 
ACE_Recursive_Thread_Mutex Admin -adminMutex, 

eh £41 2? O78 CEVCLLS ile PELL AL ALS EAE OLEEL ELS TF a 
Constructions Destruction 

Ie FEES LIP DLL LL OL dd LTE EEL LPL EL DLL EAT SAM AL LE GLE LES 


Peeee ee eee eee eee seeeeeeeeeHr Fe FeoeesstFoscsesosseeseeeeeeeeeeee 


Punction Name getiInstance({} 
Task singleton accessor function 
Return Value Admin* 


eawreeeeeeeeeeeeeeeeeeaeteeeseaseeeeeteset reo eoeeeeeaneeeeeeeeeeeeeeeees 


Admin® Admin .getInstance!) ( 


5 o PMC hrs ¢ 
thas_ = new Admini), 
) 


return this_: 
}/cend getInstance() 


i Pee eeeseeceneecenesceeoseeneeesenesesteesees eee eoesseeeteeaeeeneeeeeneeeense 


Function Name Admin() 
Task. constructor 
Return Value. none 


Pees ececeeeeseesen ee eee eeeseeeeeaseesaneeeteseseesese ee Fe Fetovrenewooneone 


Admin: Admin() { 


ptte- 3 
} 


ms_ModuleArray.empty()}: 
getMutex()->release({]; 


// delete ms_Terrain 
r1fims_Terrain) delete ms_Terrain: 


// delete the ambassadors 
af {ms_rtiAmb) delete ms_rtiaAmb; 
if (ms fedamb) delete ms_fedAmb; 


af eseeeer ee teoevoeteeeeeeeeeae eae eee e tee eaeeeneeeeean eee eeeeeeeeseteoeeeeetoeseoeseed 
// Panction Name findSimEntity( RTI.:ObjyectID objectld } 
// Task: find a simulation entity given its Object ID 


/f/ Return Value: amObject* 


Jf Cer eeeeseccvaceonenseseseececeseonsaeseneneeseseeseneesnaeeeseeeeeeoeoc® 


amObject* Admin::fandSimEntity( RTI: :ObjectID objectlId } ( 


amObject* amPtr = NULL; 
amObject* tmp = NULL; 


vector<amObject*>::const_iterator ptr; 
gectMutex ()->acquire(); 


// \terate the vector ms_amObjectArray 
for {ptr = ms_amObjectArray.begin(); ptr '= ms_amObjectArray.end(); 
ptree) ( 
tmp = (amObject*) (*ptr): 
rf (tmp && (tmp->getEntityID() == objectId)) ( 
amPtr = tmp, 
break; 
}/ifend if 
}/fend for 


getMutex()}->release(); 


return amPtr; 
}// end findSamEntity 


hie een enetooeene eae ee eee eeeeeeena eee eeee eee eerste eeeeeeet ee eee ee eee eseane 


// Panction Name findSimEntity!{ const char* moduleName } 
// Task: find a samulation entity given its Module‘s name 
// Return Value: amObject* 


ff OOS, Oe ee eC ee eel Se eee eee CECE eee ee Se Oe eee Oe ee ee ee eee ee wee Oe ewe 


amObject* Admin: :findSimEnrity( const char* moduleName } { 


amObject*® amPtr = NULL; 
amObject* tmp = NULL; 


‘f 
fof 

/ 
‘i 


try rtiaAmb 


Admin om 
Admin m 


_rtiaAmb new RTI RTlambassador 
s_tedAmb = new AdminFederateAmbaszsador 
) ¢/f Bry vrtiAmb 

catch (RTI ‘ConcurrentAccessAttemptedsi - 

( 


cerr << “Instantiate rtiAmb and tedamb® <- endl. 
cert << ke «<« endl, 


catch (RTI: . Exceptions e 


Cerr << *Instantiate rtiAmb and fedAmb* << endi, 
cerr << se «<< endl, 


createFederat ionExecution ( 
joinFederation(). 


end constructor 


ereeeeeese eee eae ee esses eeeeeeeeeeetetroeeseseeeeteetaeeeeeeee easton ae 


Punction Name -Admin ; 
Task destructor 
Return Value none 


Pees esses eee eee eee ee eHeSeeHFSee See FotHBBeotesoosesetoseeeneeeeeeeees 


Admin. :-Admin() ( 


amObject* tmp; 
vector<amObject*>..aterator ptr, 


gectMutex(})->acquire!), 


‘/delete all elements of Object Array 
ptr = ms_amObjectArray .begin(); 
while{ptr ‘= ms_amObjectaArray.end{)) { 

tmp = (amObject*)*ptr, 

rf (tmp) ( 

delete tmp, 
}/fend if 
Ptree; 


ms_amObjectArray.empty(). 


//delete ms_ModuleArray 
ptr = ms_ModuleArray .begini(), 
while(ptr != ms_ModuleArray endi)}) { 
tmp = (amObject*) *ptr: 
if(tmp) { 
delete tmp; 
d/fend if 


vector<amObject*>: :const_iterator per. 
getMutex() -~>acquire()}; 


/fiterate the vector 
for {ptr = ms_amObjectArray.begin(); ptr != ms_amObjectArray.end(); 


ptre-e) { 


tmp = (amObject*) (*ptr)., 
if(tmp && stremp(moduleName, tmp->getModuleName(}) == 0) ( 
amPcr = tmp; 
break: 
}/fend if 
jé//end for 


getMutex(}->release(}; 


return amPtr; 


)// end findSimEntity 


f/f 
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Function Name: registerObject(} 
Task: ask the RTI for a unique Object ID 

register the Object as and Entity State Object in the RTI 
Return Value: RTI::ObjectId 


ee eeeee eet eee teeeeteeceteeete Beet eoeneteeoeeteor ene aeanaeeeeeenneneaenee 


RTI: :ObjectIO Admin: -registerObject () ( 


RTI: ;ObjyectID ord = 0; 
rf ( Admin: :ms_rtiAmb } ( 
getMutex () ->acquire(); 


RTI: :ObjectIDcount numObjects (1); 
// get the ID from the RTI 


try( 
Admin: :ms_rtiAmb->requestID({ numObjects. oid. oid ); 


} 

catch (RTI: ;Exceptionk e) 

{ 
Cerr << “requestID® «<< endl; 
cerr << be << endl; 

} 


// register the ID as an Entity State Class Object 


try( 
Admin: :ms_rtiAmb->registerObject ( Admin. :getESClassHandle{}. oid }; 


} 

catch (RTI: : Exceptions e) 

{ 
cerr << *registerObject® << endl; 
cerr << ke << endl: 

} 





getMutex,, ->release, 
} ' end if 
return o2d, 


end register object 


eee e ee ee SSSSeSSHSHFSSTFHSeeeeFeeeeFeseeSeeeeetGereteetee+s-==- ee 88+ = 


Function Name Init, 

Task requests the handle values for the user defined objects in 
the FED file from the RTI 

Return Value void 


PPO ToT HESSHTSHEHSSEHTEHEH SEHR HEH SHHHSHEHS HEHEHE H HOHE SETHE SHEESH OHH EHS HEHE 


void Admin: Inat( }{ 
if (¢ Admin ms_rtiAmb | { 


4? RTTI for Objects 

try ( 
Adman. ms_ESClassHandle = Admin. ms_rtiAmb- 

pgetObyectClassHandleims_ESClassStr}, 

) 

eatch (RTI : Exception& e) ( 
cerr << “getObjectClassHandle*® << endl, 
Cerr << &e << endl, 

} 


try ( 
Admin: ms_PositionAttrHandie = Admin: ms_rtiAmb- 
>getAttributeHandle(ms_PositionStr 
ms_ESClassHandle) 
} 
eatch {RTI . Exceptions @) { 
cerr << “getAttributeHandle*® << endl; 
cerr << &e << endl; 
} 
try{ 
Admin: .ms_OrientationAttrHandle 
>getActributeHandleims_OrientationStr, 


Admin :ms_rtiAmb- 


ms_ESClassHandle}), 


) 
catch {RTI::Exception& ¢} ( 
cerr << “gecAttributeHandle” << endl, 
cerr << &e << endl; 
) 
try{ 
Admin: .ms_VelocityAttrHandie = Admin. ms_rtiAmb- 
>getAttributeHandle (ms_VelocatyStr,. 


ms_ESClassHandle). 


} 

eatch (RTI: : Exceptions #) { 
cerr << “getActributeHandle® << endl, 
cerr << &e << endl; 








































// an AttributeHandleSet that contains a list of 
// attribute type ids (AttributeHandle). 


[ [eee eceeeeen eee we ce eee nn nn ne eee ne nnn nnn nnn nee 


RTI. :AttributeHandleSet *ESClassAttributes; 
try { 
ESClassAttributes = RTI: :AttributeHandleSetFactory: create(5}); 
3} 
eatch (RTI: :Exceptions @) ( 
Cerr << “RTI: -AttributeHandleSetFactory.:create* << endl, 
cerr << ue << endl; 


) 

try { 
ESClassAttributes->addims_PositionAttrHandle} ; 

} 


eatch (RTI: :Exception&a e) { 
cerr << “*add* << endl; 
cerr << &e << endl; 


} 

try o¢ 
ESClassAttributes->addi(ms_OrientationAttrHandle) ; 

) 


catch (RTI-: Exceptions e) { 
cerr << °add* << endl, 
Cerr << ke << endi; 


} 

try { 
ESClassAttributes->add(ms_VelocityAttrHandle}; 

} 


catch (RTI : Exceptions e) { 
cerr << *add* «<< endl, 
Cerr << £e << endl; 


} 

try { 
ESClassAttributes->addims_AmmunitionAttrHandle) ; 

) 


¢atch (RTI: :Exception& e) { 
cerr << *add™ << endl; 
cerr << &e << endl; 


) 

try ( 
ESClassAttributes->addi(ms_DamageAttrHandle), 

} 


catch (RTI: :Exception& e) { 
cerr << °add° << endl; 
cerr << &e << endl, 


} 
try { 
Admin: :ms_rtiAmb->subscribeObjyectClassAttribute( ms_ESClassHandle, 
*EsclassAttributes ); 
} 


catch (RTI-:Exception& e) ¢ 
cerr << *subscribeObjectClassAttribute’” << endl; 








try! 
Admin ms_AmmunitiomAttrHandle - Admin ms_rt:Amb 
pgetAttributeHandle ims _Ammunitionstr 


} 
catch iRTI Exceptaonse ¢) { 

cerr << “getAttributeHandle*® << endl, 

cerr << &@ << end, 
} 
try{ 

Admin ms_DamageAttrHandle = Admin ms_r?2iAmb- 

>getAttributeHandle (ms_Damagesct:. 
rms _ESClassHandle 

} 
¢carch (RTi .Exceptionk -) [ 

Ceres << °“getAttributeHandle’ << end., 

cers << &@ << endl 


// RETI for Interactions 
try { 
Admin ms_CollasioniInteractionHandle = 
Admin. ms_rtirAmb- 
>getInteractionClassHandleims_Collisioninteractionstr). 
} 
eatch (RTI Exceptions ¢) { 
cerr << *getInteractionClassHandle*® << endl, 
cerr << &e << endl, 
} 
try{ 
Admin ms_EntityIdHandle = 
Admin :ms_rtiAmb->getParameterHandle(ms_EntityiIdstr 
ms_ColiisioninteractionHandle), 
} 
catch (RTI Exceptions e) { 
¢cerr << *getParameterHandle’ << endl, 
cerr << Le << endl, 
} 


}// end if 
/ end Inxe 


PeoeeSeseseseeeveseseeseseseeeeseseeseesetesseeeeeseeseseseeeseeteseeeeestene 


Function Name PublishAndSubscribe'} 
' Task informs the RT: that this federate will publish and subscribe 
ty Entity State Objects and Collision Interactions 
' Return Value void 


eoereeeeresee eee eeee eee eee See eeeeeeseeeseseseestoeseeseeeeteewoearenan 


void Admin: PublishAndSubscribe() ( 


1f { Admin: :ms_rtiAmb } ( 


// To actually subscribe and publish we need to build 


cerr << &e << endl; 





} 


cry { 
Admin: .ms_rtiAmb->publishObjectClass( 
ms_ESClassHandle, *ESClassActtributes) ; 
} 
eatch (RTI: :Exception& e) { 
cerr << *publishObjectClass® << endl, 
cerr << Le << endl: 


) 


try { 
Admin. .ms_rtiAmb- 
>subscribeInteractionClassims_CollisionInteractionHandle), 
} 
eatch (RTI. :Exceptions e) { 
cerr << “subscribeObjectClassAttribute® << endl, 
¢cerr << &e << endl; 


} 


try ( 
Admin: :ms_rtiAmb->publishInteractionClass {( 
ms_CollisioniInteractionHandle), 
} 
catch (RTI: :Exception& e) { 
Cerr << *publishinteractionClass’* << endl; 
cerr << &e << endl: 


ESClassaAttributes->empty() ; 
delece ESClassAttributes; // Deallocate the memory 
)//end if 


}//end publish and subscribe 


fé @evrersereaesrereeeeevreeteeeteserveseaeetveveseeevesseseneeseveaeeeeaased 


// Punetion Name: createFederationExecution () 

// Task makes RTI call that creates the federation execution if one 
i. does already exist 

// Return Value: void 


ff weoeeeeeeseeeseeseseeseeeeeeveeeeneeaeseseseeseneveveseseeeneseeraaeveeaeese 


void Admin: :createFederationExecution() { 


cout << “createFrederationExecution® << endl; 


try( 


Jfaaosee SO Oe eoere ipo se eee ees eS ece a ew elena ain 


// A successful createFederationExecution will cause 
// the Eedex process to be executed on this machine 


Admin: :ms_rtiAmb->createFederationExecution( m_FedExecName ); 
Sleep(2000): 





Pacteh Ri federst .onmExecutilonAlresadyExistst « 
tery << *createPederationExecurion® << endl, 
serr <« £e <« endl, 

Sle-p(500), 


-atch ¢ RTI Exceptions e ( 
cerr << “createFederationExecution® << endl, 
cere << &e << endl, 


end treavtePederationExecut ion 
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Function Name yornFederation } 

Task makes RTS cali that j01ns the federation that has been 
created 

Return Walue void 


CCHS T SSS SOF SHH SESH HHH HEHSSHEHHHESHEHSHHSSEHTSESH SHES FHE HTT BFS eB HEFT FHS HB EHF OHS 


void Admin jyoinFederation( | ( 


/f 
4s 
ft 
fi 
Li 


give join ten tries to get joined 
for «int axsO 1%<10.,ixee) | 

try 4 

mfederateID = Admin ms_urtiAmb->joinFederat ilonExecut ion [ 
“Sim_Admin*, m_FedExecName, Admin ‘ms_fedaAmb}. 

break, 

} 

catch RTI FederationExecutionDoesNotExistk e) £ 
/) mo reason to get excited fedex may not be done 


cerr << *‘Fed Ex does not exist trying again*® << endl. 
Sleep(10001, 
continue 


catch ( RTI :Exceptions = ) { 
cerr << °Fstal Error Join Failed* << endl. 
cerr << he << endl; 
exicido?, 

) 

end for 


‘Sleep to ensure federate 15 joined 


Sleep(3000); 
sectTimeManagement {) ; 


// The Admin class needs to determine what the RTI is 
‘/ going to ¢all ats class type and its sattribute’s types. 


SSS STS HSS SSH HS SHHSSSHSHSSHSSHSHSHS SHES SH SSH SHESS SHE SHHESSSHSEHSHSHEBH SHH SHE EHEDE 


Function Name advanceTime (RTI: :FederationTime ttime) 
Task: asks RTI if 1t 1s alright to advance time another step 
Return Value: void 


SSSHSEHS SHS SSHSHSHS SHH SSH SHSHSHSHS HHS HSH SHS SHSHESHS SHE HHS SHEHTS SHS SHS HSH HSHHHSBEEHEHE 


void Admin: -advanceTime (RTI: .FederationTime ttime} ( 


try ( 
Admin: :ms_rtiAmb->timeAdvanceRequest (ttime) ; 


}//try 


eatch (RTI: :Exception& e} { 
cerr << “timeAdvanceRequest* << endl; 
cerr << be << endl; 

}//eatch 


}// end advanceTimne 


aie 
// 
// 
4/ 
4 
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Function Name: taickRTI() 
Task: ticks the RTi providing processing time to clear buffers 
Return Value Boolean 


SPSSHSSSSHSSHSHSHS SHES SHESSHHSHTSSHSHSHSHSTSES SSS SHES HSHEHSHS SSS SHESHEHH HHH SH HSSHHSSH SEES 


RTS ::Boolean Admin. :tickRTI(} 


{ 


Les 
hb 
4/ 
4 
‘i 


RT 


{ 


RTI:: Boolean events; 


try ¢ 
events = Admin: :ms_rtiAdAmb->tick(); 
} 
eatch(RTI:: Exception ke) 
{ 
Cerr << *tick® << endl; 
cerr << ke << endl; 
return RTI: :RTI_FALSE: 
} 


return events, 


eeeeee eee ee eeeeeeeeeeee Ses FSSeSSe® Sess Sete eseseeeoeoeoeoeo eee eevee e 


Function Name. tickRTI(RTI..TickTime minTick. RTI: .TickTime maxTicx) 
Task: same as above except ticks RTI for a certain span of time 
Return Value. void 


COSTS SSHEHSSHSHEHSHEHSEHSHEHHSHES SS SHHHSSSEHSHSHESHHHHS SHS SHEHSHESHS SHEESH SH SESE OHH SEH ES 


I::Boolean Admin: :tickRTI(RTI: :TackTime minTack, RTI: :TickTime maxTick) 


RTI: :Boolean events = RTI: : RTI_LFALSE: 


try ( 
events = Admin: :ms_rtiAmb-otick(manTick, maxTick); 
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de 


? 


PublishAndSubseribe 


end join federation 


eevee eeFe eee SSS oSHee FSF SF SSeS SseFeeSeSeSeeeoaoxeeatoaoeteeees 


Function Name secTimeManagement!) 

Tasy, sets the RTI's time management state 
This federate 15 NOT time managed 

Return Value void 


COSHH SS SSHESHTHSSHSHESHSHESSHHEHSSHEHHSH SHE ESHEHHETEHTHEHHSHHCHOSHSOHHC ESSERE EEE EESEB OEE 


void Admin sectTimeManagement { 


try 1 
mso_rtaiaAmb->sectTimeConstrained! RTI RTI_LFALSE », 
MS _rct .Amb->turnRegulationdof f 
} 
catch RT2 Exceptions @ 3 ( 
cerr << *setTimeManagemenc” << endl, 
Cerr << ke << endl, 
) 


Y/fend setTimeManagement 


Poses seeeteeeeee ere eee ses sates eeeeseeeesteeaeaeeseseeeseeeeeeereeeed 


Function Name resignFederate! 

Task deletes federate from the fedex and destroys the federation 
af it is the last federation to resign 

Return Value: void 


SSSSSSHSSSSH SSS SSS SHS SHE SHHSHSHHSHSHS SS SHT ESHEETS SHS SES HETHETSEHSSHHSH SEH OOH OOS 


void Admin .resignFederate/) ( 


cout << *Resigning from federation® << endl, 
cry <¢ 
Admin. ms _rtirAmb->resignFederationExecution ( 
RTI ‘DELETE_OBJECTS_AND_RELEASE_ATTRIBUTES): 


} 

eatch {(RTI-: Exceptionk e) { 
cers << °resignFederationExecution® << endl, 
cerr << ke << endl; 


try { 
Admin: :ms_rtiAmb->destroyFederationExecut 10n (m_FedExecName; ; 
} 
catch (RTI: : Exceptions e) 
{ 


cerr << *destroyFederationExecution” <«< endl; 
cerr << ke << endl; 
) 


)//end resignfFederate 


VE 
Ld 
ah 
4/ 
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} 

ecatch(RTI: :.Exception fe) 

{ 
cerr << *tick*® << endl; 
cerr << ke << endl; 

) 


Teturn events; 


SHSSSSHSSHHSSSHSSHSSSEHSSSHHSHST SEH SSE HSSHHEEEHRHEHEHEHTHHEHRHEHHEHS SER EHHESHEHOEEH OS 


Function Name: addModuleFunctionPointer(amObject* amOb}) 

Task: Adds the Object associated with each module to a vector that 
will be used later to instance objects as needed 

Return Value. void 


SESHHSSHSHSHHSHSHSH SH HSHHS HHS SHEESH HE SH SHEHESSHT SS ETHESEHEHHEHTHEE ESTES EHH HEHEHE HEE HE 


void Admin: :addModuleFunctionPointer(amObject* amObj) ( 


vector<amObject*>:: iterator ptr; 
getMutex()->acquire(); 


// looks for amOb3 already in vector 
ptr = find({ms_ModuleArray.begin().ms_ModuleArray.end(),amObj) ; 


// if amObj in vector do not add 

AE (ptr == ms_ModuleArsay.end()}) { 
ms_ModuleArray.push_back (amOb3) ; 

} 

Admin: :ms_NumberModules--; 


getMutex()->release(), 


)} 4/4 end addModuleFunctronPoanter 


4/ 
4 
4/ 
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Function Name findModule(const char* name) 

Task: returns pointer to the object stored in the object array that 
corresponds to a particular module 

Return Value amObyect* 


POSH HESHSHSHSSSHHHSHSSHHSHHEHHH SS SHHEHHSHEHEHTHEH SH SH SSS HHEHSHHEHESSEHEHEBDHSHESESOH OS 


amObject* Admin: : findModuleiconst char® name) ( 


amObject* tmp = NULL; 
amObject* retOb} = NULL; 
vector<amObject*>: :const_iterator ptr; 


getMutex(}->acquire(); 


for (ptr = ms_ModuleArray.begin(); ptr != ms _Modulearray.end!); ptre) { 
tmp = (amObject*) (*ptr); 
if(tmp && strempiname, tmp->getModuleName()) == 9) ( 
retOb) = tmp; 


bresk 


‘end if 
end for 
getMutex(!->release; 


return retob). 


end findModule 


eee eee eee rFePe tor FHSS SeFFFeSeFeeteteeeeeeseeeeeeeeeee+ eevee ee en 


Function Name moduleLesdediconst char” name} 

Task boolean function returning true if module name 1s loaded 
false otherwise 

Return Value Boclean 


eeceeesreeeeeseseseeseer tees enenseneeeeeeeeeeseseeeer ee een eeeeesesenaee 


RTI Boolean Admin moduleLoadediconst char® mame ( 


RTI Booitean flag = RTI RTI_LFALSE. 
bbModule* mod = bbModule . f£indObjzect iname 


21f (mod { 
flag = RTI -RTI_TRUE. 
d'/ end if 


return flag. 
ig! end moduieLloaded 


ees eeseeeese esos se eFeF SF Seeeee eee eeeeeeeFFeaeeeeHtFFFTeTF EFF GZeeFeSeee 


Function Name addSimEntity(const char* name, RTI .ObjectID oid) 
Task adds simulation entity to the amObjectarray 
Return Value amObject® 


a¢ CTSOSCHROC CS SSESSHESSSSSSEHSSHSSH SSS SHEHSHHHEESHEHS SS SHSHTSEFEFSeeeFFTFFFeoeeeeee 


amObject* Admin. addSimEntity(const char* name. RTI ObjectID o1d} ( 


amObject* mod = Admin - findModule(name), 
amObject* tmp = NULL: 
rf(mod && mod->isTerrain()} ( 
Admin: ms_Terrain = mod->createObj ect (old); 
}/fend if 
else :f£ (mod) ( 
tmp = mod->createObject (oid): 
vector<amObject*>: iterator ptr. 


getMutex()->acquire({), 


ms_amObjectArray.push_back (tmp). 
Admin .ms_NumberAmObjects+=; 


getMutex ()->release( 


}/fend if 
return tmp; 


end addSimEntity 


Peeer es SF eee Fee eee e22S8 SF FSF FFSFFSGeFeeeeeeseee2eGeteeFvreseeeneeeneee2 


Function Name s0adModule const char* name 
Task makes bamboo cail that s90ads tne name module 
Return Value void 


eee eee eS SSF FFF FHFSFGaeeFet*eeeeeTFSF FF FFOFeeeteseeeeseeeneeeeneneenren 


void Admin loadModu.e sonst char® name [ 
bbModule® mod 


qelMi. ex’) -racquireti. 

mod - bDModule = leadiname ms_ModuleURL). 
getMutex,, rrelease 

end loadModu.e 
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Function Name unloadModu.efconst char® name 
Task. maces bamboo call that unloads the name module 
Return Value void 


eeteeee eee eee eee eee Sere eFeete ees ee eSeHFFGeer esses eseeeseeeseeeeeeenne8 


void Admin- unmloadModule,const char* name { 


boModule* mod, 
mod = bpModule findObjectiname;. 


getMutex() ->acquire }. 
bbModule -:unloadi(mod). 
getMutex()->release(}, 
//¢ end unloadModule 


SCCeoCePesee Peewee eeeseeeese seer OSFFFFFeSFeaeer= sess ee ee eeeennetenesenene 


Function Name: updatefederation(RTI :FederationTimes newTime: 

Task iterates the amObjectArray telling each localObject to update 
the federation with their current state 

Return Value void 


BPeSC SSS SSE SHSHSSHEHSHHEHH EHF SSSHSHSHSSHSHSHHESHSHSSHHHEHSHEHSHSHESTHS OHS SHS SHE SE EHHOSD 


void Admin: :updateFederation(RTI FederationTimes newTime) { 
amObject* tmp = NULL: 


vector<amODject*>:- iterator ptr. 


getMutex(} ->acquire!). 





// \terate the amObjectaArray 
for (ptr = ms_amObjectArray.begin(); ptr != ms_amObjectArray.end(}; 


ptr-e) ( 
tmp = (amObject*} (*ptr); 
if (tmp) ( 
af(tmp->locelObject{)){ 
tmp->sendUpdates (newTime! ; 
}Asend af. 
yifend if 


}/ fend for 


// do same for the terrain 
ifims_Terrain) ¢ 
rf (ms_Terrain->localoObject()) { 
getMutex()->acquire!}; 
ms_Terrain->sendUpdates (newTime) ; 
getMutex()->release(); 
) 
}i/end if 


getMutex(}->releasei). 


}//end updateFederation 


ff SPPCSHSSHSS SS SSH SHHSHHSHHTSHSHSSHSHSHHH SH SHSEHOETTESOESHHEHTOSHHEFTE OT ETERS FE® 


// Function Name. displayt} 

// Task: iterates the amObjectArray telling each amObject to display 
tf its geometry in the proper position and orientation 

7/ Return Value void 


FL SPS SHPP SS ema SOS SHHHS ST SHSEHESEHSST SOSH SHSESESOSESSESTEF ELF ESEL EHF ECEHEEEE 


void Admin.:dasplay() { 
amObject* tmp = NULL. 


ifims_Terrain) { 
ms_Terrain->display(), 
}//end if 


vector<amObject*>: :iterator ptr; 
getMutex()->acguire(). 
ptr = Admin: :ms_amObjectArray.begin(}; 
while(ptr ‘t= Admin.:ms_amObjectArray.end{)) ( 

tmp = (amObject®) "ptr; 

rf (tmp) 

tmp->display(}; 

ptre--: 

}/fend while 


getMutex(}->release(): 


}// end dispiay 
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// Function Name receiveUpdate( RTI.:ObjectID theObject. 


(/ const RTI: :AttributeHandleValuePairSets’ theAttributes. 
tee RTI: :FederationTime theTime. 

‘/ const RTI-:UserSuppliedTag theTag. 

// RTI: :EventRetractionHandle theHandle } 

// Task: sends the handle value pair to the correct amObject. 

// af the moduel 1s not loaded then the proper calls are made to 
‘/ load the module for the object to be updated 


// Return Value void 
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void Admin: :receiyveUpdate( RTI: :ObjyectID theObject. 
const RTI: -AttributeHandleValuePa:rSets theaAttributes. 


RTI: :FederationTime theTime. 
const RTI: :UserSuppliedTag theTag. 
RTI: :EventRetractionHandle theHandle )[ 


/? €ynd the correct object 
amObject*® tmp = Admin:: findSimEntity(thedbject). 


rf (tmp) { 
getMutex(}->acquire({) ; 


tmp->receiveUpdates (theObject .theAttributes, theTime, theTag) . 


getMutex()->release(), 
)// end if 


‘i add module 1 necessay or add simEntity 
else { 


cout << "Object ° << theObject << * not found - adding” << endl; 
// is module loaded 
if (Admin: :moduleLoaded(theTag) } { 
cout << "adding new ° << theTag << endl; 
Admin. addSimEntity(theTag, theObject]}, 
}// end x£ 


// 1€ module not loaded 

else { 
cout << *Loading Module ° «<< theTag << endl; 
Admin: :loadModuleittheTag) ; 
Admin: :addSimEntity(theTag, theObject) ; 

}// end else 


)/v end else 
}/fend receiveUpdate 


ff POSS SSBB SS SSHHEHSHSHEHHSS EHS HSS SHH EEHSHSSSESHSSSSHHHSSHTHTSHEHSESHET ETT TTTT Ee 


'/ Baunctson Name: recervetinteraction( RTI::InteractionClassHandle 


i? theInteraction, 

if const RTI: ParameterHandleValuePairSets& theParameters. 
oe RTI: .FederationTime theTime. 

ay const RTI. .UserSuppliedTag theTag. 

‘ft RTI: :BventRetractionHandle theHandle 


Task Sends interaction data , proper simEntity 
Return Value void 


SoOeeSeSC SSF ese eeeeeeFSeeTeZeZee2eeenaeeeaeeeserTSHFFSFeesZeeReeeeeeeeesesesen 


void Admin rece:velnteraction RTI [nteractionClassHandle theInteraction 
const RTI PsaramecerHandleValuePairSets theParameters, 
RTT FederationTime cheTime 
const RTS UserSuppliedTag theTag 
TI EventRecractionHandle theHandle 


.ttAdmin ms_InteractionFlag) ; 


RTI ObpectID oid = 0. 


af thelnteraction == ms_ColiasionInteractionHandle | 

RTI AttributeHsndle paramHandle. 
unsigned long valuevengcth, 
for {| unsagned int ix 0. ax < theParameters sizet axre 14 

paramHsandle = theParameters getHandle! ix ). 

if parsmHsandle ms EntitylIdHsndle ) ( 

theParameters getValuei ix. (char*!:&01d. valuelength 
} end it 
send for 


find the correct object 


amObject* tmp = Admin findSimEntity((RTI Object IDioid). 
rf (tmp! | 
getMutex j->-scquireli., 


tmp->receivelInteraction:theInteraction, theParameters) . 


getMutexi)->release(). 
)ifend irf 
fend raf 
else { 
cout << *Interaction not Known * «<< theiInteraction << endl. 
\/fend else 
)‘'end if InteractionFlag 


end receivelnteraction 


SHOSSSSSHS SSS STHS SSS SHS SS SSS SSSSST SS SSSHHSSHSS SHS SHHESHSHSHSHSHHSSHHEHOEHOEHS 


Function Name sendCollisionInteraction (RTI: :FederationTine 
theTime RTI :ObjectID oid) 

Task. sends Collisioninteraction data to federation 

Return Vaiue void 


Peete eee eee eB SeFZ FSS SSFSSSSSSHSSSSHSSHSHSSSSHSSHSSSHSSFSS SHH SST HSS SES SEEE 


void Admin: :sendColl:sionInteraction(RTI -FederationTime theTime. 
RTI: :Object ID o21d} ( 


RTI: :ParameterHandleValuePairSet*® params = NULL; 
RTI: :ULong numparams {1} 
params = RTI.:ParameterSet Factory. : create (numparams) ; 


Vi eeeerewmeeeeteteeeteeeeeeeSeeeeeeeSSSaeeteeteeeeeseeoseseoeosoeorweoseeeeoeeoeeesd 


// Function Name removeAmObject (RTI: :ObjectID o1d) 

// Task: does house keeping required to remove a simEntity from the 
‘? federation 

// Return Value: void 


Lf SPS SOHHHS SSH HEHE SSE HHEH HE SHHHHHHEHEHHHEHHEHHHEHHEHSHHSHSHEHSSHS EHS HESS SH SSSHOOOE 


void Admin: : removeAmObject (RTI: :ObjyectID oid} ( 
amObject* pBoid = NULL; 
unsigned int ndx = 06; 
// cheek if item to be deleted is the terrain module 
af { Admin: :ms_Terrain && Admin: ‘ms_Terrain->getEntityID() == oid }( 
if (Admin: :ms_Terrain->localOb ject ()) ( 


getMutex ()->acquire(}; 


try{ 


Admin: .ms_rtiAmb->deleteObject{ Admin: "ms_Terrain->getEntityID(). 


0.0, NULL ); 
}/fend try 
catch (RTI: :Exception te) { 
cerr << &e << endl: 
}//end catch 


getMutex()->release(!: 


d/fend af 
Admin: :ms_Terrain->deleteObject (}; 
Admin.:ms_Terraan = NULL; 


} 


else { // not a Terrain entity 


// Find the instance. 

ff ewe ww cece cme cn wren me eww we ee en ee enn eee ene nnn wee eter errr en- 
vector<amObject*>: :.terator poz: 

amObject* tmp = NULL: 


getMutex()->acquire(); 


for {ptr = ms_amObjectArray.begin(); ptr '= ms_amObjectArray.end(); 
ptre+) { 
tmp = f(amObjeect?) (*ptr): 
Lf (tmp Gk (emp->gecEntityID{) == oid)? { 
pBoid = tmp; 
break: 
}/fend if 
}//end for 
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params ->addigetEr.tityldHandle ( ehar®! vid eszeof!RTI Object zD) | 
gectMutex() -vacquire’), 
try ( 


Admin ms_rtiAmb >sendinteraction‘getCollisioniInteract ironHandle 
*parsams. theTime NULL 
i 
eatch(RTI Exceptions @,? 
cercr << te <« endl, 


gectMutex(!)->release ( 
end sendCollisioninteraction 


SSCS SESS HS SSE SSS SHS SSS SSHSHS SESE SSEHHESHSSESHSSSSSSHS SE SSHESHS SSS SS ESE SETH EEE 


Function Name sendEntityUpdate{RTI Object ID thedbject. 

RTI ttributeHandleValuePairSeca ctheAttrabutes, 

econst RTI UserSuppliedTag theTag 
Tash. sends the handle value pair from an entity to the federation 
Return Value void 


eeeeee eee ee ee teseeeeeeeeseeeeeeeeSee eee eeoenereoeeeteseeeeseeeeseeeee 


void Admin: ‘sendEntityUpdate (RTI ObjectID theObject. 
RTI: ‘AccributeHandleValuePatrSet& theAttributes, 
const RTI UserSuppliedTag theTag) ( 


RTI. FederationTime theTime - mlastTime « ms_grantTime, 


getMutex ()} ->acquire(). 


try 
Admin: ‘ms_rtidmb->updateaAttrsbuteVslues( theObject. 
theAttributes., theTime, theTag }; 
J// Must free the memory 
theAttributes.empty(), 
)/ fend try 
catch ( RTI: : Exceptions @ } 
{ 
cerr << be << endl; 
}/fend catch 


getMutex() ->release(); 
}//end if 
m_lastTime = theTime. 


)//end sendEntityUpdate 


if { pBoad }{¢ 
Admin: :ms_NumberAmObjects--; 


[ | won nn nnn een en een ene nn en nn ene nnn ene en enn ene een ene enn e ee 


// Tf the instance is a local object 
// we should delere at from the RTI space. 


| fnen nnn nee ee en ne ooo oe ee ne ee ee = = 
if ( Admin: :ms_rtiAmb && pBoid->localObject{) }( 
try 
Admin: :ms_rtiAmb->deleteObject{ pBoid->getEntityIDI{}. 
636.) NULL); 
) 
catch (RTI: : Exception &e) { 
Cerr << Ge << endl; 
} 
d// end if 
else { 
ff wm mer eee ew ew ee me en on we ee wee eee eee re ewer een soce- 


// Otherwise, this is a remote object that removeObject was 
// called on. 
I foeoowns mcm creer crrere erect ersa- - ++ wee cer ee ere----- ece---- 
//We don't need to do anything here 
j//end else 
ms_amObjectArray. erase (ptr); 
pBoid->deleteObject (): 


}ifend if 
getMutex()->release(}: 


)// end else 
)//end removeAmObject 
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// Functaon Name removeModule (const char* moduleName) 
// Task: removes module object form moduel array 
// Return Value: void 


(Epp SESH SSSHSSSSSSSS SHS SS SSSS SS SHES SHS SHSHSHT SS SSS SSSHSSSTSHS SSE FS OHHO HB SEH E DHE 


void Admin: :removeModule{const char* moduleName) ( 
amObjeet*® tmpObject = NULL; 
amObject* tmp = NULL; 
unsigned int ndx = 0; 


a a ean a el a ae 


// Fand the position of this instance. 
vector<amObject*>:: iterator Ptr: 
getMutex ()->acquire(); 


for (ptr = ms_ModuleaArray.begin({}; ptr !* ms_ModuleArray.end(); ptre=) { 
tmp = ({amObject°?! (*ptr): 
iffemp 4& (stremp(tmp->getModuleName().moduleName) ==6)) { 
tmpObject = tmp: 
ms_ModuleArray.erase (ptr); 
break: 


end if 
) ‘end for 


gerMutex()->release 


rf, empobjyect ) 
{ 


Admin :ms_NumberModuies 


delete cmpobject. 
endif 


send remove Module 


eeceseeee tte er SP eZee eee SH FTES SHS SHHE SSE SHSSSTHTSESH ee etre steeeHeoe: 


Function Name checkEntityCollision;amObjecct® that} 

Task: a terates ObjectArray looking for collis:ons with other 
entities 

Return Value amObjzect* it collided with 


eecereece etter ee SeeeveeeeeeeeeeeeeeteoetHHeSFeHeeeRee eee eee220282822809 080808 


amObject*? Admin .checkEnsityCollision amObjece* that) { 


amObject* tmp = NULL, 
amObject*® retOb) = NULL. 


vector<amObject*>. iterator ptr. 
tr = Admin ms_amObjectArray begin 


getMutexi)-racquire(!. 


whialeiptr '=+ Admin :ms_amObjectaArray end) ( 
tmp = {(amObject®*) *ptr, 
r€é (emp "= chat! ( 
if (tmp->checkColliasion(tnat) } ( 
retOb) = tmp: 
break. 
}//end if 
}/fend if 
ptr-e; 
}//end while 


getMutex()->release(). 


return retoOb), 


‘fend checkentityCollision 


evrereeeeesceeseeeeee es eee eee eeseeseseeet ere eot ener eeeat ear eeoeeeeeeteon 


Function Name getMutex i) 
Task: pointer to Admin class Mutex 


* Return Value: ACE_Recursive_Thread_Mutex® 


‘ 
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EXECUTIVE SUMMARY 
File Name AdmainFederateAmbassador h 
Author: CPT Stewart Liles. Naval Postgraduate School 
Description: Method Definitions of AdmanFederateAmbassador class 
This file defines Federate ambassador functions required for 


proper execution in this federation 


September 1998, Masters Thesis 


SOSH SSSSS SSS HTS SHS HS HSS SSH SSS STS SH SSF FS SHS SSTHSSTFESSeFesZeeFoeoHseeeeHeee 


®ineclude °Rei. hh? 


@. 


fndef _Adm:nFederateAmbassador 


fdefine _AdminFederateAmbassador 


class AdminFederateAmbassador 


{ 


public RTI - FederateAmbassador 
e 


public: 


ibe 


FUGALETGTLEET ALLTEL ELL AEE LETITIA 


// Federation Management Services // 
TALE LD DISASAPAELETAALA MIATA ELAS 


hee 


2.6 


virtual void initiatePause [ 


const RTI::PauseLabel label} // supplied C4 


throw { 


fd 


RTI: : FederateAlreadyPaused. 
RTL: .FederatelInternalError)}) ; 


2.9 


virtual void initiateResume () 
throw [ 


RTI: : FederateNot Paused. 
RTI: -FederateInternalError). 


TL 2 12 
virtual void anitiateFederateSave | 


const RTI: :.SaveLabel label) // supplied C4 


throw ( 


RTI: :UnableToPerformSave, 
RTI: : FederateInternalError}), 


Virtual void initiateFederateSave | 


const RTI: -‘SaveLabel label. 
RTI:.:FederationTime theTime 


// supplied Cé 
// supplied C1 


throw [ 


RTI: .InvalidFederationTame. 
RTL: :UnableToPer formSave. 
RTI: : FederateInternalError) ; 


Lolo arelG 


Vi 


rtual void initiateRestore ({ 
const RTI::SaveLabel label} // supplied C4 





53 


ACE_Recursive_Thread_Mucex* Admin getMutex 
return btadmninMuter 


end admin c 





throw ([ 
RTI: : SpecifredSaveLabelDoesNotExist. 
RTI: :CouldNotRestore. 
RTI: :FederateInternalError}); 


VUAMEVA TAL ALE LALA ELDEST AEE EL TI DLALS 
// Declaration Management Services // 
VLE VAP ELAL SALTS PATA LIATAL ALG GAATAT AL 


bless 
virtual void startUpdates ( 
RTI: .ObjyectClassHandle theClass. 

const RTI .AttributeHandleSeté& theAttributes) 
throw ([ 

RTI: : Obj, ectClassNotPublished,. 

RTI: :AttrabuteNotPublished. 

RTI: -FederateInternalError), 


supplied Ci 
supplied C4 


virtual void stopUpdates | 
RTI: :Ob) ect ClassHandle theClass. / supplied ¢2 
const RTI: AttributeHandleSece theattributes) ‘/ supplied C4 
throw |[ 
RTI: :ObzectClassNot Published. 
RTI: :AttributeNotPubl ished. 
RTI: :FederateInternalError): 


// 3.6 
virtual void startInteractionGeneration | 
RTI: .InteractionClassHandle theHandle) // supplied Cl 
throw ( 
RTI: .InteractionClassNotPublished. 
RT1.:FederateInternalError}. 


virtual void stopinteractionGeneration ( 

RTI: -InteractionClassHandie theHandle) /- suppized C2 
throw f[ 

RTI. .InteractionClassNot Published. 

RTI : FederateIncernalError) ; 


PIP EPADE ATE AIL STILE ELL SPELLS 
// Object Management Services // 
ELDALDLIIAAL LL AS SALAD ILI ALT ILLEL LA 


4/44 
virtual void daiscoverObject ( 


RTI. ObjzectID theObject. ‘/ supplied 
RTI :ObjectClassHandle theObjectClass // supplied 
RTI -FederationTime theTime ‘/ supplied 
const RTI: UserSuppliedTag theTag. // supplied 
RTI. EventRetracrionHandle theHandle) // supplied 


throw |[ 
RTI: .CouldNotDiscover, 
RTI: .ObjyectClassNotKnown, 
RTI::InvalidFederationTime. 
RTI: : FederateInternalError); 


hires S 


ISA 
ep 
ci 
c4 
ci 


ve.rtua,. void refiectAttributeVaiues 


RTI Object ID theobjec: ‘| gupplied C1 
const RTI AttributeHsndleValuePsirSet& theaAttributes. supplied Ci 
RTi FederationTime- theTime. supplied Cl 
const RTI UserSupp.iedTag theTag. supplied C4 
TI EventRetractionHandle theHandle, i supplied Cl 
Arrow | 
RTI ObjectNotKnown 
TI AttriabuteNotKnown 
RTT InvalidFederationTime 
RTI Federateinterna Error 
. 
Jertual void rece:veinteract iar 
RTI InteractionclassHanudle theintersction supplied <1 
const RTI ParameterHandleValuePa.rSet& theParameters. suppired 24 
RTI FederationTime theTime i+ gupplied Ci 
-onst RTS UserSupp|iedTag theTag ‘ supplied 74 
RTI EventRetractionHarndle theHandle supplied C1 


throw 
RTi InteractionClassNotknown 
aie Interact. onParameterNotKnown. 
RT: InvaiidFederazionTime 


= 


Ta. FederateiInternal£Error 


a 9 
Virtual void removecbject [ 

RTI .ObjyectIC theObject, | supplied ¢2 
RTI ObjectRemova. Reason theReason. '/’ supplied ¢€1 
RTI FederstionTime theTime., supplied Cl 
const RTI UserSuppl:edTag theTag ‘¢ supplied C4 
RTI EventRetractionHand.e theHandle! ‘ supplied Cl 

throw { 


RTI ObjectNotKnown. 
RTI InvaladFederstionTime. 
TL FederaceInternal£Error). 


virtual void removeObject { 
RTI .ObjeerID thedObject. ‘/ supplied Ci 
RTI .ObjyectRemovalReason theReason} «/ supplied Cl 
throw ( 
RTL :ObjectNotkKnown, 
RTI InvalidFederationTime. 
7: FederateInternalError]). 


4215 
virtual void provideAttributeValueUpdate ( 
RTI: :Ob)ectID theObject. // supplied Cl 
const RTI :AttributeHandleSet& theaActtributes: // supplied C4 
throw [ 


RTI- -ObjectNotKnown. 
RTI: AttrabuteNotKnown. 
RTI .FederateinternalError) ; 


4617 
virtual void reflectRetraction ( 
RTL: :EventRetractionHandle theHandle) // supplied ¢l 


ET Sor 
virtual void informAttributeOwnership ( 
RTI: :ObjectID theObject, // supplied ¢l 


RTI: :AttributeHandle theAttribute, // supplied ¢2 

RTI :FederateHandle theOwner) // supplied ¢1 
throw ( 

RTI: : FederateInternalError} ; 


GRADS I LIAL AL REELLELECLAAATAELT 
// Time Management Services // 
LE LEREEELIRALLELEGAEEELEEDL EET 


/! 6.10 
virtual void timeAdvanceGrant ( 

RTI: :FederationTime theTime) // supplied Cl 
throw { 

RTL. : InvalidFederationTime. 

RTI: .TimeAdvanceWasNotInProgress. 

RTI: : FederacionTimeAlreadyPassed. 

RTI: : FederateInternalError); 


TALALT ALLS ALATA ATANA LNA DELLE. 
// Data Distribution Management // 
FLETTTTTTTTTTTTTET TTT EAA ALA 


Tits 
virtual void changeThresholds { 
RTI: : Region theRegion, // supplied 
RTI-:ThresholdSets theThresholds) // returned 
throw ( 


RTI: :RegionNotKnown., 

RTI: :FederateInternaiError) ; 
// 6.17 PM 9/28/96 federateAmbServices AR 5 
protected: 


private 


i: 
tendif 


throw 
RTI EventNotKnown 
RTI FederateinternalError 


VILA EE SELL ILA EEL EL EET 
wwmership Management Services 
A PECTIN AE ELIETTEIR ELT 


ed 
vartual RTL AttributeHandleSets 
requestaArttributeOwnersh ipAssumption 


returned C6 


PTI Ob ect ID rtheObyec: supplied C1 
const RTI AttributeHandleSetu offeredAttributes supplied C4 
const RTI UserSuppliedTag theTag> supplied C4 


throw 
RTI ObjectNotKnown. 
RTI AttributeAlreadyOwned. 
RTI FederateiInterna.Error 


virtual RTI- ActributedandleSeri // yvyeturned C6 
TrequestAttributeOwrershipAssumption 
RTI Object ID theObject. ‘ gupplied Cl 
const RTI: AttributeHandleSets offeredattributes;: «/ supplied C4 
throw ( 


RTI: Object NotKnown. 
RTI AttributeAlreadyOumned. 
RTI FederatelInternai£Error), 


fe S38 
Virtual void attributeOwnershipDivestitureNoti fication ( 
PTI :ObjectiIDd theObject. // supplied Cl 

const RTI: AttributeHandleSets releasedAttributes; // supplied C4 
throw [ 

RTI -ObjectNotKnown. 

RTI: :AttributeNotKnown. 

RTI -FederateinternalError). 


Ci 308 
virtual void attributeOQwnershipAcquisitionNotification ( 
RTI: - Object ID theObject, // suppiied Ci 

const RTI: .AttributeHandleSet& securedAttributes) // supplied C4 
throw { 

RTL. : ObjyectNotKnown, 

RTI: ActributeNotKnown, 

RTI: .FederateInternalError) ; 


if 3.6 
virtual RTI: :AttributeHandleSeta 
requestaAttributeOwnershipRelease [ 


// returned C6 


RTI : Object ID theObject. /+ supplied Cl 
const RTI: :ActtributeHandleSets candidateAttributes. // supplied C4 
const RTI: :UserSuppliedTag theTag) // supplied ¢c4 


throw ( 
RTI: : Object NotKnown. 
RTI: :AttrabuteNot Known. 
RTI: :FederateInternalError) ; 


Ly SOSH SHSHSS SSS SH SSSH FSCS HHH HSHHSHSHSEHHSHHHS SHH SHHSHST SHE SHHOSSESHTSSET ET EHTEEe 


4/ EXECUTIVE SUMMARY 


// 

// File Name: AdminFederateAmbassador.c 

4/ 

// Author: CPT Stewart Liles, Naval Postgraduate School 

4/ 

// Description: Method Definitions of AdminFederateAmbassador class 
// This file defines Federate ambassador functions required for 
i proper execution in thas federation 

Le 


// September 1996. Masters Thesis 


f/f FOF S SHS SSH SSH HF SH SSFP SSS SHH FSS SHFESSHHHET SHS SHE HHFEST SHS SETTER SET HTT SS 


Winclude *AdminFederateAmbassador.h” 
include *Rti.hh* 
#inelude *admin.h* 


VELLEETEEEEITLEALLTEELEL PEE ELTELELSISL TLL EL PELL MATTE EL ILEL TALS LEELA SS 
// Ad@minFederateAmbassador Class 
VELITAAAALLEED SEPT ERVEEEL EDDIE ALLELE LI AAT AAT ALAS AL AT EPL EL 


TEELELTELELPLELLELPELEELLET EL LELLELELELEELELOLTAALLL ALATA ALA LEE 
// Construction/Destruction 
VLELLTTATTITAT LAL EEELTLELI LIA LEIA LASALLE LEELA LI TAA TELA AAAS ELE 


TILECPTTALELAIDALCLPELIAMLS ALAALAIAA EAL 
// Federation Management Services // 
VIAALULEELL AE LALLA ELLE ELELA DELILE 


void AdminFederateAmbassador: :initiatePsuse! const RTI: :PauseLabel label ) 
throw (RTI: :FederateAlreadyPaused, 
RTI: :FederateInternalError) 


// Not amplemented in 1.0 


void AdminFederateAmbassador: :initiateResume () 
throw (RTI: :FederateNotPaused, 
RTI: :FederateInternal£Error) 
{ 
// Not implemented in 1.0 
} 


void AdminFederateAmbassador: -initiateFederateSave| const RTI :SaveLabel 
label ) 
throw (RTI: :UnableToPer formSave, 
RTI: .FederateInternalError) 

{ 

// Not implemented in 1.0 
Sifdef TEST_SAVE 

saveFlag = RTI: :RTI_TRUE; 

cerr << “*initaateFederateSave called with label = ° << label << endl; 
fendif 
} 





void AdminFederateAmbassadc: -yatrateFedersteSavefcons: RT. SavelLabe! 
labe} 
RTI FederationTime theTime) 
throw (RTI -InvalidFederationTime, 
RTI UnableToPerformSave. 
RTI .Federateinternal€rror 


Not implemented in i 6 


void AdminFederateAmbassador. initiateRestore const RTI SaveLabe! labe}) 
throw (RTI SpecifiedSavelLabel DoesNotExist 
RTI CouldNotRestore 
RTI Federateinternai€rror) 


‘ Not implemented in i 0 


ee EAL EL ET Foe CL EID PEPE FTE ET 
Declaration Management Services // 
PEELE SE ELE FENCES get GAG PPL L ELS 


void AdminFederateAmbassador: startUpdates (RTI: ObjectClassHandle theClass 
¢onst RTI: AttributeHandleSets 
theActributes} 
throw (RTI ObjectClassNotPublished. 
RTI: -AttributeNotPublished. 
RTI: : FederatelInternalError) 
( 
cerr << °AFA.-startUpdates* << endl. 


void AdminFederateAmbassador:: stopUpdates (RTI: : ObyectClassHandle theClass. 
const PTI :AttributeHandleSets 
theAttributes) 
throw (RTI:.ObjyectClassNotPublished. 
RTI. .ActributeNotPublished. 
RTI .FederateInternalError)} 


{ 
cerry << “stopUpdates® << endl: 


| fecccen nee nce--- 0-5 ee eee e+ +e -- we ee en nw oo ee ee ee - - ~~ 
// Never gets called in 1.0 but we will amplement it for good form. 
[ [own ncn cow en mew ee teem ene eee e eee ene Oe wm ew ewe ewe e eee www mem enn ence 


void AdminFederateAmbassador: :startInteractionGeneration 
(RTI. InteractionClassHandle theClass) 
throw (RTI InteractionClassNotPublished. 
RTI. FederateInternalError) 
{ 
cerr << "startInteractionGeneration”™ << endl: 





}// end discover object 


void AdminFederateAmbassador: :reflectAttributeValues 
( RTI: :Object ID theObject. 
const RTL: AttributeHandleValuePairSet& theAttributes, 
RTI: . FederationTime theTime, 
const RTI: .UserSuppliedTag theTag. 
RTI: : BventRetractionHandle theHandle ) 
throw (RTI. :ObyectNot Known, 
RTI: .AttrabuteNotKnown,. 
RTI: InvalidFederationTime. 
RTI: . FederateInternalError) 


Admin: :receiveUpdate (theObject. theAttributes,theTime, theTag. theHandle} . 
}// end reflectAttributeValues 


void AdminFederateAmbassador: :receiveInteraction 
{ RTI: .InteractionClassHandle thelInteraction, 

const RTI: :ParameterHandleValuePairSeth theParameters. 

RTI: :FederationTime theTime. 

const RTI :UserSuppliedTag theTag. 

RTI: :EventRetractionHandle theHandle)}) 

throw (RTI: -InteractionClassNotKnown, 

RTI: : InteractionParameterNot Known, 
RTI InvalidFederationTime. 
RTI: : FederateInternalError) 


Admin: receivelInteraction(theInteraction, theParameters, theTime, theTag, theHand 
le): 


) 


void AdminFederateAmbassador :removeObject( RTI.:ObjectID 

theobject, 
RTI: :ObjyectRemoval Reason 

theReason, 
RTI: -FederationTime theTime. 
const RTI: :UserSuppliedTag theTag. 
RTI: : BventRetractionHandle theHandle 


throw (RTI :ObjectNot Known, 
RTI: : InvalidFederationTime. 
RTI.:FederateInternalError) 


( 
Nae eae ae ee en ww ae ee nie aie ete eee eteaceoccacaess oe 
f/f Call the other removeObject method since this should probably 
// be implemented using default parameter values. 
ff reseagica sass seae saan accel aa csia as Sassen s a wee aa eceswea Soe acces wece-- 
removeObject (theObject. theReason) ; 

} 


void AdminFederateAmbassador: :removeObjecti RTI: :ObzectID theObject. 
RTI: :ObjectRemovalReason theReason) 
throw (RTI. : Obj ectNotKnown. 


Admin ms InteractionFlag 2s RTL_TRUE 
+ 


void AdminFederateAmbassador stopInteractionGenesation 
RTI IncteractsonclassHandle thel.ass 
throw (RTI Interact:ionClassNotPubi:shed 
RTI FederatelnternalError 


terr << “stopiNteracticnGenerstion® «<< end), 


Adm:n ms_InteractionF.ag - RTI RTI_FALSE 


Pi / f hibditok t Ctlit dae Lihat earet 
Sbyec: Management Services 
FERED h RAPT faen Rh tn ope eek he Mane we, 


void AdminFederateAmbassador d:iscoverObject RTI ObjectID 
thedbject 

RTI ObjectClassHandle 
theObjectClass. 

RTI FederationTime 
theTime. 


const PTI UserSuppl:edTag theTag 
RTI EventRetractionHandle 


theHandle 
throw (RTI CouldNotDiscover. 
FTI ObjectClassNotKnown. 
RTI InvalidfederatzionTime. 


RTI FederateInternal€rror) 
i 


endl. 


/? 3s this an objec: type I know sbout 
if (theObjectClass == Admin gecESClassHandle') ) ¢ 


/? 3s module loaded 
1f :Admin moduleLoadeditheTag) } { 

Admin addSimEntity(theTag. theObject). 
d// end if 


// x~€ module not losded 
else { 

Admin: loadModule(theTag), 

Admin: addSimEntity(theTag. theObj ect). 
}// end else 


}// endif 
else { 


cerr << *Discovered Obect class unknown to me ° << endl, 


)// end else 


RTI .InvalidFederationTime. 
RTI. .FederateInternalError) 
{ 


cout << “AFA: :removeObject*® << endl; 
Admin: : removeaAmObject (theObject) ; 
} 


void AdminFederateAmbassador: provideAttributeValueUpdate 
( RTI::ObjectID theObject. 
const RTI: AttributeHandleSet& theAttributes} 
throw (RTI ‘Object NotKnown, 
RTI -ActributeNotKnown. 
| RTI. : FederateInternalError) 


| } 


| void AdminFederateAmbassador ‘reflectRetraction( RTI: SventRetractionHandie 


theHandle ) 
throw (RTI: : EventNotKnown, 
| RTI. - FederateInternalError}) 


cerr << *AdminFederateAmbassador: :reflectRetraction: handle = * << endl; 


‘/ T dadn‘t amplement this one - sorry' 


PELALDGT ALG LELI LICL EEINAS AA ERLLSLALEL 
// Owmership Management Services // 
FELAPUELEL DALAL LAS FLAT ATADID AANA LAL 


| RTI: :AttributeHandleSets& 
AdminFederateaAmbassador: :requestaAttributeOwnershipAssumption 
{ RTI..ObjectID thedbject. 
| const RTI: .AttributeHandleSets offeredAttributes, 
const RTI UserSuppliedTag theTag) 
throw (RTI :ObjectNotKnown, 
RTI: :AttributeAl readyOwned. 
RTI: : FederateInternal Error) 


// I da@an‘t amplemenc this one - sorry! 


' // The follow:ng is to allow it to compile with the SparcWorks comp.ler 


RTI: :AttributeHandleSet* dummy = 

RTI. .AttributeHandleSetFactory: :create (0}; 
return *dummy. 

} 


RTI :AtctributeHandleSet& 
AdmanFederateAmbassador..requestAttr.buteOwnershipAssumption 
| ( RTI: :Object ID theObject. 

const RTI: :AttributeHandleSets& offeredAttr:butes !} 


| throw (RTI : Object NotKnown. 


RTI. :AttributeAlresdyOwned., 
| RTI. : FederateInternalError) 


a2 





| rout << “AFA discovered object * <« thedbjyect << * Module ° <« theTag << 


T didn't amplement this one sorry 


The following is to allow it to compile with the SparcwWorks compiler 
RTI AttributeHandleLet® dummy = 
RTI AttributeHandleSetFactory createio). 
return °dumny. 


vord AdmainfederateAnbassador attrsbuteuwnershipDivestitureNotification 
RTI Obyect id rheObject. 
const RTI AttriabuteHandleSets releasedAtt ributes 
throw (RTI Object NotKnown. 
RTI AttsibuteNot Known 
RTI FederaceinternsatError 


Af 


I didn’t ésmplement this one - sorry' 


void AdminfFederateAmbsssador attributeOwnershipAcquisitionNoti fication 
RvI .Object Io thedbj ect 
const RTI AttributeHandleSets securedaAttributes 
throw (RTI. -ObrectNotKnown, 
RTI AttributeNot Known 
RTI. : Federaceinternalfrror 


I didn‘c amplement this one - sorry’ 


RTI: -AtctrabuteHandleSets 
AdminFederateAmbassador requestAttributeOwnershipRelease 
( RTI -ObjectID thedbject 
const RTI .AttributeHandleSets candidateAttributes. 
const RTI..UserSuppliedTag theTag | 
throw (RTI: ObjectNot Known 
RTI: AttributeNotKnown, 
RTI: FederateInternalError) 


I didn’t implement this one - sorry! 


++ The following 1s to allow 1t to compile with the SparcWorks compiler 
RTI .AttributeHandleSez* dummy - 
RTI: -AteributeHandleSetFactory create(6}, 


return “dummy, 
\ 


void AdminFederateAmbassador ainformAttributeOwnership 
( RTI: -ObjectID theObject. 
RTI. .AttributeHandle theAttribute. 
Ti-:FederateHandle th-eOwner) 
throw (RTI::FederateInterna Error) 


/ 1 didn't implement this one - sorry’ 


ML PALE LEAL LE RAE ET Le 
Time Management Services // 


4/ eeeereer eer ere ereeeeoevreeoeeeeeseeeeeeeeeeeeeeereneeeetTeeFeeeteneeteeeevee 


4/ EXECUTIVE SUMMARY 


Jf 

// File Name: amObject.h 

‘if 

// Author: CPT Stewart Liles. Naval Postgraduate School 

tt 

‘¢ Description: pure virtual class defining the interface between 

tf adminModule objects, the federate Ambassador and rti ambassador 
‘it 


// September 1998. Masters Thesis 

f/f @eeee eee ea eeeeaaevreanaene ee eee ee eevraaeawvperveaeae een ee eevee vreeevae eee eee eeeanaeneaeneaee 
sinclude “npsQuaternion.h- 

Winclude "npsVec3f h* 

Wanclude *Re1i.hh- 

®include *ace/OS.h* 


Hifndef _amObject 
tdefine _amObject 


Hifndef SIM_API 
fifdef VISUALCPP 
wdefine SIM_API __declspec(dllimport) 
felse 
tdefine SIM_API 
tendif 
endif 


class amObject 


{ 

public: 
// member variables 
RTI: :ObjectID entityID; 
npsVecif position; 
npsQuaternion orientation, 
npsVec3f velocity; 
int ammunition; 
floac damage: 


amObject (RTI: :ObjectID} ; 
amObject (); 


s/getters of Entity State fields 


RTI::ObjectID getEntityId(); 


mpsVeci3f£ getPosition(); 
mpsQuaternion getOrientation(); 
npsVec3f getVelocity(): 
int getAmmunition(); 
float getDamage(), 


//setters of Entity State fields 


void setEntityID(RTI: -ObjectID) ; 
void setPosition(npsVec3 £) ; 
void setOrientation(npsQuaternion); 
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void AdminFederateAmbastador timeAdvanceCrant' RTI FederationTime theTime 
throw (RTI InvaiidFederationTime 
RTI TameAdvancewaaNotInProgress. 
RTI FederationTimeAlreadyPassed., 


TI PFeaderateInternal€rror 


Get the teme granted to and the flag to let me know 
time has changed 


Admin ms_grantTime > theTame 
Admin. .ms_timeaAdvGrant : RTI RTI_TRUE. 


ry MEL ELLE LL EEELE CELLAR LE LELELL ALOR ELE AAHEL EP DCES LL pee 
Data Distribution Management - NOT IMPLEMENTED IN 1.0// 
PME LTT IALIT CLI ALALAL TAAL EL ALLELE LEELTALALAL SDT LIE ILE LL 


void AdminFederateAmbassador -changeThresholds RTI Region theRegion, 
RTI ThresholdSets tneThresholds 


throw (RTI RegionNot Known. 
RT2 FederateInternalError} 


// Not amplemencted in 1.6 


void setVelocity (npsVec3£) ; 
void setAmmunition(int); 
void setDamage{ float); 


// RTI ambassdor interface 
virtual void sendUpdates(RTI.:FederationTime theTime) = 0; 


Virtual void sendUpdates(RTI.:ObjectID, RTI: AttributeHandleValuePairSetsé, 
RTI: :FederationTame, RTI: .UserSuppliedtag) = 0; 


virtual void sendInteraction(RTI.:InteractionClassHandle, 
RTI: : ParameterHandleValuePairSeth&. RTI :FederationTime. 
RTI: :UserSuppliedTag) = 0. 


// FederateAmbassador interface 
virtual void receiveUpdates (RTI: :ObjyectiD oad. 
const RTI: :AtctributeHandleValuePairSets ta. 
RTI: :FederationTime £t, RTI: :UserSuppliedTag tag) = 0; 


virtual void receivelInteraction(RTI-:InteractionClassHandle. 
RTI: : ParameterHandleValuePairSet&. RTI: :FederationTime, 
RTI: :UserSuppliedTag} = 0; 


virtual void receivelInteraction(RT!: :InteractionClassHandle. 
const &TI.:ParameterHandleValuePairSetts) = 6; 


// Object display 


virtual void display{) = 0; 


virtual amObjyect* createObject (RTI: :ObjyectID) = 9; 
virtual void deleteObjyectl) = 0; 

virtual char® getModuleName(}) = 0; 

virtual RTI: :Boolean localObject(} = 0; 


virtual RTI: Boolean checkCollision(amObject* that) = 0; 
virtual float checkTerrainCollision(amObject* that}= 0; 
virtual RTI: Boolean isTerrain() = 0; 

}; ¢/ end amObject 


wendif 


Peoeceece sts eo eeeseneeeeweeeeeeeeeeeesesseeeeeee eee eeee eee ene eeeteeanees 


EXECUTIVE SUMMARY 


File Name amObject.¢ 


Author CPT Stewart Liles. Naval Postgraduate School 


amBoid Files 
Defines the base object that must be inherited by ail 
sederation 


Deser:ption 
participating in the 


September 1998, Masters Thesis 


ereeceee eer eeeeeeeee 2222888 288 ee Fe Fee BeBFeHRFEB BFE EHH OBRHHE THB BE BEE 


#tinclude “‘amObject h° 


amObjyect amObject (RTI ObjzecstID oid) { 
entityID = oid. 
}// end amObject 


amObject. amObject{) () 


//getters of Entity State fields 


RTI: ObjzectID amObject. gecEntrtyID{)( return entitylID. } 

npsVec3f amObject getPosition{!) (return position: } 

npsQuaternion amObject: getOrientation{) {return orientation, } 

npsVecif amObyect getVelocity() (return velocity. } 

unt amObject: getAmmunition() (return ammunition, ) 
boat amObject. getDamage(} (return damage. } 


/fsetters of Entity State fields | 


void amObject: 
void amObject: 
void amObyect 
void amObject. 
void am0bjecct- 
void amObject: 


-setEmtatyID(RTI: -ObjzectID oid} (entityID = oid: } | 
;setPositioninpsVec3f£ number) {position = number. ) 
‘setOrilentationinpsQuaternion number) (orientation = number,, 

:setVelocity (npsVec3f number) (velocity = number, } 

:setAmmunitioniint number) (ammunition = number, } 

setDamage (float number) (damage = number, } 





LF PSS eS OS OS SO SOS OO S182) S008 SC O:6 0:8 610 ©. O10: O06: 0'8 8.01628 6:8 O06 62'S 0 80:6 Ole aw aie & 


// EXECUTIVE SUMMARY 


This is the module.txt for the amBoid module 


Lt 
Bamboo? . 0b // File Name. module.h 
4 Lt 
npsVisualModule // Author. CPT Stewart Liles. Naval Postgraduate School 
bbKeyboardModule /f 
npsFlyingCameraModule // Description: defines methods pertinent to module loading and unloading 
amHLAAdmin ve 


// September 1998. Masters Thesis 


ff POPP ePewerevrecce sec ere eFererevesererercoReecoe Les eeSsEseRZeseonEeZeLLe 


amCheckerboard 


fifndef __ module 
tdefine _ module 


fp Pe eeeeeeccccrenecerecccsccscenececcccccceovreseoeervresensecereesegecees 


Lf INCLUDES AND EXTERNS 


772 SOSH HSSSSSHEHSSEH SHS HFSSHSFTHHSSSSEHO SFT SSSS SSS HFSS HF Fe SF eee FHT FHF SHS eF+E8 


Tel. ereeeeFeeeceeseees eee ee ers eeeeeeee ee Fe Senseo eeeeeseeeeeeeneee Geer eeertees 


if DEFINES 


Tt SoSH OTE HHO SESS HSFTHO SHER SHEHHE OHO HSHOHCHEHHESOHOHE SSH SeSSHeESEesEH Fe ee eeeeeeeee 


/d Se eeeeeeeeees FF FFFF FF FFFFFFFFFF FFF F2H9R 22229222 9482 288 B SH ee BEB SOHO He 


/} FUNCTION PROTOTYPE SPECIFICATIONS 


ff oes £2208 © 6:0)9'# 2:0:0.0 10 618 8648/0 )e 6 6.0 006 6 2:8 C'n)0 0801016 0 6'019 0:40:00. 0'e 0:82 eC: ee s\e:8 


tifdef _ cplusplus 
extern *Cc° { 
tendift 


ADMIN_API const char *getModuleName(). 
ADMIN_API float getModuleVersion(}. 
ADMIN_API const char *getModuleDate(); 
i ADMIN_API const char *getModuleText(); 
: ADMIN_API bool inatModule({); 

ADMIN_API bool exitModule()}; 





Wifdef _ cplusplus 
} 
bendif 


5 a 


t / 
Lat: 
/ 


INLINED MEMBER FUNCTIONS 


COST OSSHSFEOFSHSOSSEHESO SHOT SSS FFF FFF HRP H HF eB ee Fee FHF HF eF HH Fe eee eee FES eee 


endif // module 


at nC 


eenrseeeeeeeeeeeeeseeeseeseeseer= eset eeeePeeePeeeeee: eee eee8 28828: Foe @ 


EXECUTIVE SUMMARY 
Frle Name module c 
Author CPT Stewart Lives Nava. Postgraduate School 
Description detines methods pertinenr to module loading and unloar.ng 


September 19989 Masters Thesis 


SCoeeeeeeSeSS SES Fe SSF eZeeseeeeesseanrenseeeeeeeeeeeeeee2ee22 9280282880842 8 


em me OCHO ee HBR SOHOHSF SESS HESSSSSSSHSSSSSHSHSHSHSHSHHSSHHSSHE SSS HSHHHEHHHSHHSSFEEe 


INCLUDES AND EXTERN. 


CHOSSHSTSSSSSSSSSSSSSZ FSF SSSSFHSFF HS SHSHSFZEFSHHB ZF SBF HF SBF SHHHHHSHSHF eB SSH EEe 


tinclude <stdio h> 
timelude <stdlab h> arog 
tinclude *module hh” 
®#include "amBo:id h* 


SOS SSSCS SHS SS SSSHSOHSSHEHSSHSSEHSSSSHSHSSEHSHHHSSHTH SH SHSHSSHEHSHSSS SESS SHH EH HEED 


CODE 


ee eeeee eee ee e2eeeee2eeee2 et eFFFeFFFFFFFFHFSHHeeeFFHOFFFFTFeTeeseeee 


omst chars *getModuleName() 


return °amBo1d” 


float gectModuleVersion() 
{ 
return : oO. 
) 


ynst char *getModuleDate() 


return *1998/069/0601 066 OS 48” 
} 


const char *getModuleText (} 
{ 
return °*This 15 a really nice module”. 
} 


bool initModule({) 
{ 
rnitamBoidit). 
return 1, 
} 


bool exitModule() 
{ 
exitamBoid!(). 
return 1: 


} 


Jf PP Pere cer vecerrecesccvercc erence vecereee eres reer sere sees ee eeees 
tf EXECUTIVE SUMMARY 

o File Name: amBoid.h 

a Author: CPT Stewart Liles, Naval Postgraduate School 

a Description: defines methods pertinent to module loading and unloading 
. September 1998. Masters Thesis 


J4/ SSCS SHSTHSS SHS SS HSSSHSSSHHSS SHH SHS SHSSSHFSSSSHSSSSSSSSS SSF HSSSETSSSSS SST SERFS 


#ifndef _amBoid 
#define _amBoid 


Eee O02 9,0) 9188) 8) 218 eee 18) SCO 16) 610/001 S191 8) 010) 2) 0) 9.6.8 OC, 0)S 6)01 8.8 019) S15) 8501016 S16 6) 91818 618 S812 se ioe 


df INCLUDES AND EXTERNS 


4/ SHOSSCSTFT SSF eSHSeesePFeeeeeeeseeeHsHoe SSeS SeeeeeeFeF TTT FTSeTS eevee eo eB OO ee 
Lf SE Swe OC si8 so O'88:6'e's'6 6 F616) 086.68 1S 6.6 60'S 666 SUES 6:F:OE C'S UO 9:0 HOO 4M 8188 Re 


f/ DEFINES 


LJ SOSH SSCSSSSHSHSSSOSSHSSSOSSSSSSSSSESS SCH SHSSSHHOHOSHHHOSCSEHEFHESVT STOVE 


JJ PSPSPS SS SHS SS SOTSSESTSESHHTSTSETSHSFESHSTHEFTHTHHHETETTSSF SVE FES SHHEEEE 


tf FUNCTION PROTOTYPE SPECIFICATIONS 


Die S LSS eS PS 0818) 8181S 26218. 0, 9,018.82 .8 O88) O18 8188 FOS 21S e ee eel eee COS SS: S'S) SSeS) e268 )5 5218 


void anitamBoid(!, 


void exitamBord!}). 


FL PIP oeePoeeececscecesoe ee sssescoevsscssssesesossesvcsosscnsesesecervetesoveerece 


4/ INLINED MEMBER FUNCTIONS 


ff SPSS SSSS SSH HSSSHSSSS SHS SSSS SESH HSSSHHHSSSHTSSHSSSSSESES ESTES HET SSH HHO SE 


wendif // 
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EXE-UTIVE SUMMARY 
Firie Name amBoid h 
Author CPT Stewart Liles. Naval Postgraduate Schoo. 
Description defines methods pertinent to moduie loading and unloading 


September 1999, Masters Thesis 


eee eeeeeee ee es ee See eee Ses SFFFeF Fees esses esses SSKT SSS FFF FFe e820 8908 


tifndef _amBo.d 
tiefine — smBo:d 


Sore eteeoeeeesees ee ee emn eee eer eseeeeeeseeeeee ees eeeseeseesseeeeeeeeeeee9 


INCLUDES AND EXTERNS 


Poet PS seessees Pees Se ePF FSF FFFFFFSFSeFFFFFFeeFeeseeeeesesesegeeeeeeseeRete® 


DEFINES 


SSCSSHS SE Se FFF F FEF FFTFTSSSSFFeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee2e2299808898 


BOSSE SSS SH SSSHHSSSHSSHSSSSH SSS HHH SHS SHS SSSFSFSSSFSSSFTVseTFTFeeeseeee8 


FUNCTION PROTOTYPE SPECIFICATIONS 


void xwnitamBo.idt{). 


void exitamBord!), 


f PPS SSS SSF SSF FSS HSHTHSSFSSSSSS SSS SS SFHTSHSFSSSSSSSSHSSSSSFSFFF SHS FHHETETF9RE8 


| INLINED MEMBER FUNCTIONS 


,f 8h OC SCCPeem eee eee FFs esenseseseeeeeeeseseereeeeeeeeeseseseseeeneeee 


wmendif // 


ee: SPOSSHSHSSSSSSSHSS SHS SSPHSSSHTFSHTHSTSTHFSSSHSSSFTHS FS SHEHHTHH SESS SHFFTFTFFSFFTTF#Oe 


if EXECUTIVE SUMMARY 

i File Name amBoid.c¢ 

y Author: CPT Stewart Liles. Naval Postgraduate School 

i Description: defines methods pertinent to module loading and unloading 
a September 1998. Masters Thesis 


if £2 2) SSSIe 88) 9. 0S OO 20'S #O)9 SSS SC V1C10 SSS O10 C10 SS 6 C10 |S 010 C.F 8191S SC FO FSS) OO 0:99 908 eel eles) 


ref SCSPCHSHSS SS SSTSSHS SSS SFeFSSFSSEFGeseFeFeFFaseFeeseeFeFSFeaesSSssssseeseseeeeee 


fi INCLUDES AND EXTERNS 
f/f e@eeceveveeveee eee eoeeeeeeoeeeeseeeveveeeeeeeeeeveneeeeeeeeneeeeeeee9e9e909999002 00290808080 
®include "Rta. hh* 

e:neclude *amBoid.h°* 

®include °npsVisual.h°® 
Minclude "npsWindow.h” 
include "npsViewport.h°* 
Winclude °npsFlyingCamera.h° 
include "bbMouse.h* 

®include °bbScereen.h° 

include *bbKeyboard.h°* 
®Winclude “*bbEventResponse h°* 
®include *bbCallback.h* 
include *napsGeometry.h°* 
#ineclude *boid.h° 

®inelude "“amHLAAdmin.h* 
®include "admin. h’* 

Pinclude "amObject.h° 

#include <math.h> 

#include <GL/gl.h> 


ifdef SGI 
#include °bbSGI.h* 
wendif 


f/f SSCSCHHSSSSSSS SSS SSS SSS SHSSSSHF SS SHSSSSSSSSSSHFSSSS SSS SSS SS SHHHHEHEHFER OE 


4 CODE 


ff Se ePeeeeeeeceevseecsececeeveseovececsesseseceseseesceesessesevererzcenecs 


Boid *myBoid; // global local object 


//€Eunction prototype 
int mouseInwWindow(); 


ee Pee Fe Fe SFTSeFSSFTFFseeeFFeFseFTFSFFFFFFFFeFFFFT FEF ESeeR222222828222299 88 


// Panetion Name initamBoid() 
// Task: initialize Module -- this is run only once 
// Return Value: voad 


Ef CLS S OSS OLS SES OS OS SS OS SS SOS 180 SCS S 1618/0 S 08 C8018) 9,8 )8) 818) 0) SSeS) 0.2.0. 2:0 6:09 6.0 = 


void initamBoid() { 


Void initKeyboardModule! 


void initwvisualModule 


myBoid = new Boidi}. 
Admin addModuleFunct | me @ ites myBo.d 


tnitKeyboardModule 
myS3oid = NULL, 


cout <«< "amBoid Module loaded” «<< end. 
end snitamBoid 


eee ecee eee eee eee SSF FT SS SSHHEHF Se eeesFeeeeBeeeneeeseeseneseeeeeenr 


Function Name exitamBSo1d\ 

Task does housexeeping required to exit the Module -- 
this 1S run only once 

Return Value void 


eee eecesce tem ese eeseeeeeeseseeteseeeeeeeeee2ee2e222828 828829828 SF Fees eeeese 


void exitamBoid({} / 


thts 
ff 
ff 
4/ 


bbCallbackHandler *csllbackHandler. 


uint numCallbacks. 
uint currCal .back. 
bbCallback *callback. 
want currDuck; 
npsGeometry "duck, 
bbKeyboard* keyboard; 


bbEventResponse* eventResponse. 


remove keyboard callbacks 
| RESET 
eventResponse = bbEventResponse findObject|"amBo1ldER_Reset*). 
callback = bbCallback findObject ("amBoidReset*); 
eventResponse->removeCcal lback (callback) ; 
delete callback, 


‘/ yvemove Keyboard callbacks 

// LoadBoid 

eventResponse = bbEventResponse :findObject | *amBoidER_LoadBoid"}, 
callback = bbCallback-.findObject (*amBoidLoadBoid*}; 

event Response->removeCallbackicallback), 

delete callback, 


/? €irst remove update callback 
Callback = npsVisual. appCallback(); 
CallbackHandles = cal lback->getPreCal lbackHandler (}; 
callback = bbCallback :findObject {(*BoidPreApp”) , 
rf (callback) { 
cal lbackHandler->removeCal lback (callback), 
delete callback: 
)/fend if 


Function Name ainitVisuslModule({} 
Task: attache callback to PreApp callback handler ain Visula Module 
Return Value void 


SCHR HECHT HEE EEE HEE SEES HEE OEE Hee EHH eee eeeeeeeeeeeeeeee 


void anitVisualModule(} { 


Oe: 
i/ 
t/ 
df 
if 
‘/ 
oe 


void initCheckerboardFunc(bbObject ‘object, bbData cdata); 
void preAppFunctbbObject ‘object. bbData *data): 


npswWindow *window, 
npsViewport “viewport; 
npsCamera *camera. 
bbEventResponse ceventResponse, 
bbCal lbackHandler *callbackHandler, 
bbCallback "callback, 
npsVecif position, 
npsQuaternion rotation; 
npsGeometry *checkerboard, 


// pre app callback 

callback = npsVisual: appCallbacki}; 

callbackHandler = callback->getPreCallbackHandler (}; 
callback = new bbCallback{), 

callback->setName ("BoidPreApp*) ; 

callback->setFunc (preAppFunc} ; 
eallbackHandler->addCallbackLast icallback) ; 


// end anrtVisualModule 


eevee eoeeeteeeeeeeeee eee eee eeeeeeeeeseeeeeeeeeotatbeeeeeeeeeeEeeeeeee 


Funetion Name preAppFuncibbObject "object, bbData *data) 
Task: defines preApp callback function -- 

uses keyboard controls to maneuver Boid 

checks for collisions 
Return Value void 


e@eeeeeee see e te te tee ee ee eee eee tee ere eeeteseaeeeseseesesesetteooteteos 


void preAppFune (bbObj ect *object, bbData “data) { 


void deleteMyBoid(), 


float cosh, sinh, cosp. sinp, cosr. sSinr, 
bbKeyboard *kd; 

npsCamers "camera. 

mpsVeci£ position; 

npsQuaternion rotation: 

npsVecif tmpVec; 

float hpt (2 y% 

float velocity = 0; 


kd = bbKeyboard: :getInstance(), 
camera = npsCamera findObject ("AdminCamera”). 


SO 


remove remo te amubjerc 
amCbject® tnecbjyeace AGM. © £2 eo Se ety’ ~amBc! i” 
while thedobjyece 
Admin removeamobjye-" cneubp ect sazetEntityld 
theobvect - Admin findSsmErtst, °*amBoid” 


remove the moduse from modu.e 112° 
Admin removeModule °arSo:d” 


end exitamB: .d 


eCoece etree sm eet eer eseeeeeeeZe2FSseF SF FFF FFSSSFHFESTTEHSF DSH OHHEB OOH EEE EFS 


Function Name) iunitKeyboardMcdules 
Tasn ad? keyboard ca.lbacks 
Return Value void 


ewoeteetstoeee sees FFF FFeSSeeF FFF FFF sOSeFeoeFeFseeneeensteunneerneneen 


oid initKeyboardModulet: { 


void escFuncibbOb3ect ‘object bbData "data 


void resetruncibbObjecc ‘object, bbData “*data) 
void loadBoidibbObject *object bbData ‘data. 


bbKeyboard keyboard, 
bbEvent Response *eventResporse 
bbCsllbac« *callbach. 


é/ get the Keyboard device 
keyboard = bbKeyboard .getlinstance 


'/ set up reset key 
| eventResponse = new bbEventPesponss obKeyooard KEY_SPACE). 
evenctResponse->setName | °amBoidER_ Reset* 
callback = new bbCallback |) 
callback->sezFune (resetPunc 
callback->sectName {"amBoidReset®), 
event Response->addCallbackLasticallback , 
Keyboard->addEventPesponse eventResponse) . 


// set up load boid key 

eventResponse = new bbEventResponsei(bbKeyboard.:KEY_B | 
bbKeyboard: .DOWN_TRANS) , 

eventResponse->setName (“amBoidER_LoadBoid”), 

callback = new bbCallbackt)., 

callback->setFunc (loadBoid) ; 

callback->setName (” amBoidLoadBoid”}, 

eventResponse->addCalibackLasticallbachk), 

keyboard->addEventResponse eventResponse}) ; 


fend initKeyboardModule 


@eeeteeeceeseeeeeeeewmseee eee eeeeeseeeeeeteee ees eeeseeseeseeeeHeeeeeeeeee® 





//don’t do anything unless there 1s a local boid to control 
if (myBo1d) ( 


position = myBoid->getPosition(); 
rotation = myBoid->getOrientation(), 
rotation getEulers(hpr), 


// Need this to control] each window separtely 
// key commands won't work unless the mouse pointer 
// is in the window 


if imouseInwindow())f{ 


// update rotation 
2£ ( kd->getVal (bbKeyboard .KEY_LEFTARROW) } ( // heading left? 


| 
| hpr(0} += NPS_DEG2RAD(4.0£); 
af (hpr(0} > NPS_?I) 
hpr(0) -= 2.0£°NPS_PI; 


te 1 


f£ { kd->getVal (bbKeyboard. :KEY_RIGHTARROW) ) ( // heading right? 
hpr[0} -= NPS_DEG2RAD(4 Of): 
2.£ ¢thpr(0) < -NPS_PT) 
hpr(0] «= 2.0£*NPS_PI; 
if ( kd->getVal (bbKeyboard- :KEY_UPARROW) |1{ // pitching up? 
hpr(1} += NPS_DEG2RAD(4 Of): 
rf (hpr[l] > NPS_PI*°0.49S£) 
hpr(1] = NPS_PI*0 495f£; 


{ kd->getVal (bbKeyboard. :KEY_DOWNARROW) }{ // pitching down? 


re 
rH 


hpr(1] -= NPS_DEG2RAD(4 Of); 
2£ thps(1) < -NPS_PI°O.395£)} 
hpr(1) = -NPS_PI°0.49S£; 

} 


rotation.setEulersthpr). // set quaternion 


if { kd->getVal (bbKeyboard: -KEY_S} && kd->getVal ibbKeyboard: : KEY_A) 
1 ¢4 dead stop 
velocity = 0.0£; 


| :/ update velocity 


else if ( kd->getVal (bbKeyboard: -KEY_S) // accelerate 
velocity «= 1 2€, 

else if ( kd->getVal(bbKeyboard: .KEY_A} | // decelerate 
velocity -= 1.2£; 

else { // slow down 


velocity -= 0.1€, 
else if (velocity <= -0.1f) 
velocity «=: 0.1f; 


\ 
| 2£ (velocity >= 0.16) 


a 


elie 


VO as A 


are: velocity > 2 .amp veleraty 2 <2 velwcity < 


velocity | 10% 
else 1£ velocity < a O'S 
veloc.ty 2 cof 


end 1f mouselinwWindow 


update pos:tion 
Wstic RTI Obj e225 oid a 
ed 0, 


entacy collision 
pid = myBoaid=>hasCollided|{ 
float yPos QO, 
RTZ Boolean terrainFesatureCce .iision RTI RTI_FALSE, 


check collision with terrain 

.fiAdmin ms_Terrain’ { 
yPos = Admin ms_Terrain->checkTerra:nCollision(myBoid), 
rerrainFeaturecollision = Admin ‘ms_Terrain->checkCollision(myBoid) 


terrain 1s returning & y Position 
afiyPos °- 0 Oy ¢ 


tmpVec.setio Of O Of. -2 3f1', «4: forward 
tmpVec scale(velocity). 

rotation. xform tmpVec); 

position add(tmpVec). / set vecit 
position set(l.yPos). 


myBoid->setVeiocity(tmpVec) . 
myBoid->setPosition(position). 
myBoxrd->setOrientation(rotation), 
camera->setPosition(position), 
camera->setOrientation(rotation). 


)/vend if 
boid collided with terrain feature 
else if(terrainFeatureCollision { 


tmpVec.set (myBoid--getVelocity()). ‘/ forward 
// tmpVec.scale(velocity?, 

rotation. xform(tmpVec), 

position.subitmpVec); // set vecif 

position. subi(tmpvVec) : 

position.subitmpVec); // set vecif 

Position. subitmpVec} , 

Position.sub(tmpVec); // set vecif 


myBoid->setVelocaty(tmpVec) ; 
myBoid->set Position(position! ; 


npsCamera’® camera; 
npsVecif£ tnitPosition; 
npsQuaternion anitRotation; 


if (mouseInWandow() && myBoid) { 


unatPosition.set(0.0£f, 3.0£, -10.0£): 
anrtRotation.setEulers (NPS_DEG2RAD(180.0£),.0.0£,0.0£}; 


myBoid->setPosition(anitPosition); 
myBoid->setOrientation(initRocation) ; 
)// end if 


) ¢/ end resetFune 


de: 
4/ 
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ble 
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Funetion Name. loadBoiad(bbObject cobjyect. bbData °data) 
Task: funetion defined for the loadBoid keyboard callback 
Return Value. void 
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void loadBoidibbObjece "object, bbData edata) ( 


void anitVisualModule({); 


if (mouse InWindow()) ( 
cout << *loadBoid”® << endl; 
rf ('myBoid? { 
initVasualModulei). 
RTI: :ObjyectID oad = Admin: :registerObject (), 
amObject® tmp = 
Admin: :addSimEntaty(°amBoid*’, oad); 
myBoid = (Bo:d°)tmp; 
myBoid->setLocalObject (RTI: :RTI_TRUE} ; 
}//end if 
)/fend if 


}// end loadBoid 


eh 
fi 
Ld 
4d 
4f 
// 


Function Name mouselInWindow() 

Task: cells if mouse is in the correct window to receive keyboard 
commands 

Return Value: int representing boolean 
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ant mouseInWindow() ( 


unt flag = 0; 


npsWindow “window; 

npsViewporct "viewport; 

window = npsw:ndow :faindObject (*AdminwWindow”); 
Viewport = npsViewport: : findObject {“AdminViewport’); 
float x.Y, 

x = bbMouse: :getX{); 

y = bbMouse: :getY(): 
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myBcid->»seti rientation. rotation 
Camera->setPosictcion{poeit.ion). 
TCAMATS- FH S42UTISenCalion rotation 


bo:d no ¢ol.ision 
else .f oid -: 0 + 
empVec set C Of 9 Sf -1 Cf. forward 
tmpVer sca.eivelocity), 
rotation xformi(tmpVec}, 
position add(tmpVec), ¢/ set vaecit 


myBoid >setVelocity (tmpVerc 
myBo.d->set Position’ position,, 
myBoid->set2rientation rotation!. 
cam4ra->set Position position 
camera->sertOrientation rotation 


)/ fend else if 

/?¢ boid collided with entity 

else( 
tmpVec seci0.0£. 0 Of. -1 Of,, ‘/ forward 
tmpVec scaleivelocity), 
rotation xform(tmpVec) , 
Position.sub(tmpVec), // set vacié 
Position sub(tmpVec), 


myBoid->setVeloeity ftmpVee). 
myBoid->setPosition( position), 
myBoid->setOrientation{rotation}), 
camera->SetPosit:on(pos:tion); 
camera->sectOrientation(rotation 


cout << *Collided with entaty ° << oid << endl, 


RTI FederationTime theTime = 0.0; 
myBoid->sendCollisioninteractionitheTime, ord); 
}//end else 


// check 1f Bord is destroyed in some way 

if (myBoid->gecDamagei! < 0){ 
deleteMyBoid{); 

} 


ir’ end if myBoid 


)/ and preAppFune 
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‘/ Funetaon Name resetFuncibbObject "objzect, bbData “data, 
'' Task: function defined for the resetBoid keyboard callback 
/ Return Value: void 
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void resetFune(bbObject "object. bbData °data) ( 


bbScreen: :normalizeVal {&x, by); 


if (viewport->getWindow()->i1sValInside(x.y)) ¢ 
flag = 1; 
} 
return flag; 
}//end mouseInwindow 


void deleteMyBoid() ( 
bbhCallbsckHandler 
bbCs llback 


*callbackHandler; 
"callback, 


Admin: .removeAmObject (myBoid->getEntityID()); 
myBoid = NULL; 


}//end deleteMyBoid 
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static RTI Bovlean ms_sendrotationUpdates 
EXECUTIVE SUMMARY static RTI Boolean ms_sendPositionUpdates 
static RTI Boolean ms_sendComminteractions, 


File Name Boid h 
member functions 


Author CPT Stewart Liles. Naval Postgraduate School public 

Boid)). 
Description defines boid class Boid) RTI ObjyectID idt 

void setLocalObject RTI Boolean 
September 1996 Masters Thesis RTI ObyecctID hasCollideds 


eereeeeeeresree eee See eeeseeeeeseeeereseseeseeeeeeeeeeeeeeeeseeeeeeeorze 


virtua. ~Boid , 
include °R¢: hh* 


@include °npsVec3£ h° virtua. void dispisy ) 
tanclude °npsGeometry h° 
@ineclude *bbKeyboard h’* virtual amObject*® createObj ect (RTI ObjectiD ord) 
#include *amObject h° 
Wimelude cadmin h° | virtual void deleteObj ect {:, 
tafndef ADMIN_API virtual char’ getModuleName/). 
ifdef VISUALCPP 
tdefine ADMIN_API __declspecidllimport) virtual RTI Boolean localdObject /) 
telse 
tdefine ADMIN_API Virtual RTI..Boolean isTerrain/}. 
wendif 
fend. f 4/ Methods acting on tne RTI 
class ADMIN_API Bold public amObjyect ! virtual void sendUpdates(RTI .FederationTime newTime 


{ 
virtual void 


‘¢memeber variables sendUpdates(RTI ObjyectID,RTI AttributeHandleValueParrSets, 
public: RTI-.FederationTime. RTI UserSuppliedTag). 
ACE_Recursive_Thread_ Mutex theMutex, 
virtual void receiveUpdates {RTI .ObjyectID oid. 
// tame management data memebers } const RTI .AttributeHandleValuePairSetés hyps. 
static unsigned int ms_extentCardinality. RTI: :FederationTime fc. RTI .UserSuppliedTag tag). 
static RTI: -Boolean ms_timeAdvGrant, 
static RTI::FederationTime ms_gran:Time. void sendCollisioniInteraction(RTI :FederationTime 
static char’ ms_ModuleName, newTime, RTI: :ObjecctID oid), 
virtual void sendinteraction (RTI- :InteractionClassHandle 
private: RTI ParameterHandleValuePairSez& RTI FederationTime. 


RTI :UserSuppliedTag}. 
RTI: : FederationTime m_lastTime. 
virtual void receiveInteraction( RTI: .InteractionclassHandle 
npsGeometry® myGeom; theInteraction. 
const RTI: :ParameterHandleValuePairSets theParameters 
// Change flags for attribute values; 
F virtual void receivelInteraction(RTI InteractionClassHandle t2. 
RTI: :Boolean hasPos:tionChanged, RTI :ParameterHandleValuePairSects phvps. RTI: .FederationTime fc. 
RTI: :Boolean hasRotationChanged., RTI-:UserSuppliedTag tag): 
RTI. :Boolean localFlag: Virtual RTI-:Boolean checkCollision(amObject* that); 
| 
| 


virtual float checkTerraincollision(amObject* that); 
// Update Control flags 
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4/ EXECUTIVE SUMMARY 


/? Accessor Methods 


¢/ Static Accessor Methods | ‘/ 
// File Name- Boid.c 
RTI: : PederationTime GetLastTime([) // 
{ return m_lastTime, }; // Author: CPT Stewart Liles. Naval Postgraduate School 
// 
private: | // Description: method definitions for the Boid class -- 
void initBoidGeometry(}. i tf Bold class represents the class that is implemented by the amArena 
static void initBo:dFuncibbObject “object. bbData ‘data}; Le module. 
float distanceFromi(npsVec3f thatPos); ‘/ 


protected: 
RTI: :AttributeHandleValuePairSet? CreateNnVPSet (); 


// September 1998, Masters Thesis 
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de 


#include °*RTI.hh°* 
#include *boid.h° 
*include *npsGeometry.h°* 
#include °*bbKeyboard.h°* 
#include <GL/gl.h> 
fanclude *admin.h* 
Wanclude “amObject.h’* 
Winclude *amHLAAdmin.h” 


// Extent data memebers 
unsigned int Boid: :ms_extentCardinality = 0; 


char’ Boid::ms_ModuleName = *amBoid’; 


LTTTEREERLATTLLEGLL ELT ELLLALE LE LATTA ELT LLLLEL AMT LAL TERT ETE LA tee 
// Construction/Destruction 
LRLLTALVATAAMATECLIALLETALSASUTIAAAAAL ELLA LAAT HAT ADILE ALLER EL LER ES 
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| // Panction Name Boid( RTI::ObjectID 1d) 
// Task- constructor -- instance intializer 
// Return Value: void 
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Boid::Boid{ RTI::ObjectID id) 
m_lascTaime (0.0) ( 


secEntityID(aid); 
npsVec3£ xx; 
xm. set(0.0£.0.0F.0.0f), 
| setPosition (xx); 
npsQuaternion yy: 
setOrientation (yy): 


sectDamage (10.0); 
localFlag = RTI: :RTI_FALSE: 


anicBoidGeometry({): 
Boid. :ms_extentCardinalityes; 


end sNstruc 
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Function Name Boad 
Task constructor 
Return Value void 


COCSE SHEESH ERFHSHOHTEHRHSHSEHO SS OBF SSB SHEE BOesTeeHoZrOXTEF FFB SSH SHER FeHeEHE 


used for obyect storage .n ModuleaArray 


Bo:d Boid 


m_SastTame 9 90 { 
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Function Name -Boid 
Task destructor 
Return Value void 


Boid -Boidt { 
remove the Object from the 


Boid ms_extentCardinality 
sf \myGeom! 
delete myGeom, 


end destructor 
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Function Name sendUpdates (RTI: ObjyectID oid. 
RTI AttributeNandleValuePsairSeth Ca, 
RTL FederationTime ft, RTI: UserSuppliedTag tag) 

Task not implemented ain this module -- pure virtual funetion must 
have definition 

Return Vaiue: void 
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void Bord: .sendUpdates (RTI: :Obj;ect ID ord. 
RTI. -AttributeHandleValuePairSeth ta. 
RTI: :FederationTime £t. RTI: :UserSuppliedTag tag) 
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Function Name sendUpdatesi{RTI. .PederationTime newTime) 
Task: send handle value pair to rte. for update to federation 
Return Value: void 
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void Boid :sendUpdates (RTI: :FederationTime newTime) { 


/ Update state of Boid 


}/4/ end for 


}//end recevieUpdates 
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‘/ Punetion Name. receivelInteraction (RTI: :InteractionClassHandle ach. 
f TI -ParameterHandleValuePairSeté& phvyps. PTI.:FederationTime ft. 
’ RTI: -UserSuppliedTag tag) 

// Task: not amplemented in this module -- pure vartual function must 

Tih have definition 

/¢ Return Value: void 
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void Boid:.receiveInteraction (RTI: :InteractionClassHandle ich. 
RTI: .ParameterHandleValuePairSets phvps. RTI1::FederationTime ft. 
TI: :UserSuppliedTag tag) 

() 
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// Punmetion Name receivelnteraction | 

/é RTI: : InteractionClassHandle theInteraction. 

4/ const PTI::ParameterHandleValuePairSet& theParameters } 
// Task. recieves PHVP and decodes for use with module 

// Peturn Value: void 
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void Boid: receiveInteraction( RTI: :InteractionClassHandle theInteraction, 
const RTI: :-ParameterHandleValuePairSets theParameters | ( 


rf itheinteraction == Admin: .getCollisioninteractionHandle()) { 
setDamage (getDamage!) - 1.0); 


cout << °**Sollision Detected -- Object ° << getEntityID(} 
<< ° Damage = ° << getDamage() << endl: 


} 


}/fend receivelnteraction 
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‘/ Punetion Name sendCollisioniInteraction(RTI: :FederationTime theTime, 
t/ RTI: :ObjectID oid) 

// Task: sends rti the PHVP using the send interaction fuention 

// Return Value: void 
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void Boid. :sendCollisionInteraction(RTI: :FederationTime theTime. 
RTI: :ObjectID oad) { 


//build paramter handle value pair 
RTI: :ParameterHandieValuePairSet® params = 
RTI: : ParameterSetPactory: :create (i); 
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RTI Att ributeHandleValueRa:irSet* pNvpSet = Creat eNVRSeat 


Admin sendEntityUpdate: getEnt.tyID .*pNvpSet. getModuleName' 


set m_lastTime to newTime 
M_lastTime - newTime, 


end sendUpdstes 
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Punction Name receiveUpdates! RTI Sb;ectID oid 
const RTI AttriabuteHandieVacueRairSeti cheAttributes, 
RTI FederationTime theTime, RTI UserSuppliedTag theTag) 
Task Gecodes HVP from PTI for this object: 
Peturn Value void 
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void Bo:id receiveUpdates( PTI ObjeceID o1d, 


conse RTI AttributeHandleValuePazrSech theaAttributes, 
RTI :FederationTime theTime. RTI UserSuppliedTag theTag) ( 


RTI AttributeHandle attrHandle. 
unsigned long valueLength., 


‘4 We need to iterate through the AttributeHandleValuePairSet 
‘/ CO extract each AttributeHandleValuePair. Based on the type 


/? specified [{ the value returned by getHandle()} )} we need to 
// extract the data frlom the buffer that is returned by 

{ getValuesi. 

for ( unsigned int i = 0. 1 < theAttributes .sizel), 160 , 


{ 

attrHandle = theAtcributes getHandle( 2: 1}. 

rif ( attrHandle z= Admin .getPositionaAttrHandle } } 

{ 
npsVec3£ tmp; 
theAttributes.getValue{ 1. (ehar®*}&tmp. valueLength ): 
setPosition (tmp). 

}//end if 


else if [| attrHandle =: Admin :getOrientationAttrHandle!, | 


// Same as above goes here... 
npsQuaternion tmp. 
theAttributes.getValue! 1. (¢har*)&tmp. valueLength }; 
setOrientation (tmp! ; 
)// end else if 


elise if ( attrHandle == Admin: :getVelocityAttrHandle() } 


// Same as above goes here... 
npsVec3£ tmp: 
theAttributes.getValue( i. (char*)&tmp. valueLeagth ); 
setVelocityitmp). 
}// end else if 





params->add (Admin: :getEntityIdHandle({), (char’) soid. 
sizeof(RTI-:ObjectID)}; 


sendInteraction (Admin: :getCollisionInteractionHandle()}.*params. 
theTime. NULL); 


}//end sendCollisionInteraction 


dee 
/i 
4/ 
tf 
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Function Name: sendInteraction(RTI: :FederationTime ft) 
Task: send the PHVP for the given interaction 
Return Value. void 
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void Boid. :sendInteraction(RTI: :InteractionClassHandle ihc. 


RTI: :ParameterHandleValuePairSet& phvps. RTI::FederationTime ft, 
RTI: :UserSuppliedTag tag) { 


try{ 

Admin: :ms_rtiAmb->sendiInteraction(ihe.phvps. ft.tag); 
) 
catch(RTI: : Exceptions e) { 

cerr << ke << endl; 


} 


}//end sendInteraction 


4/ 
4/ 
df 
// 
eh 
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Function Name: CreateNVPSet [)} 
Task: creates HVP set pertinent to this object 
Return Value: AttributeHandleValuePaisSet° 
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RTI: :AttributeHandleValuePairSet* Boid: :CreateNVPSet[) { 


RTI: :AttributeHandleValuePairSet® pBoidAttributes = NULL; 


{// Make sure the RTI Ambassador as set. 
zf ( Admin: :ms_rtiAmb } 
{ 


// Set up the data structure required to push this 
// objects’s state to the RTI. 


RTI: :ObjectIDcount numAttributes (3); 
pBoidAttributes = RTI: :AttributeSetFactory::create( numAttributes ); 


pBoidAttributes->add( Admin: :getOrientationAttrHandle(). 
ichar’} sorientation, 
sizeofinpsQuaternion) }. 


pBoidAttributes->add/ Admin: :getPositionAttrHandie:). 


(char®})&position, 
sizeofinpsVec3£) }; 


pBoidAttributes--add({ Admin getVelocrtyAtt rHandle( 
ichar‘j&velocity 
SizeotinpsVec3£f} 3}, 


return pBoidaActribuctes, 


CreateNVPSec 
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Function Name display} 
Task updates geometry position and orientation 
Return Value void 
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void Boid .display i [ 
myGeom->set Position{(getPosition{)). 
myGeom->setOriencatronigecOrientation()), 


1 ¢ end display 
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¢ Function Name creaceObject (RTI ObjectID o2d) 
+ Task creates an object and returns a pointer to i% 
+ Return Value amObject°* 
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amObject® Boid -createObjecc (RTI .ObjectID o1d} { 
Boid* tmpBoid = new Bord/oid). 
return (amObject*}tmpBoid, 

}/fend createObjece 
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// Function Name deleteObject () 
‘/ Task. remote delece function 
// Return Value. void 
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void Boid.:deleredObject () { 
delete this; 
) 
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‘/ Punetion Name getModuleName() 
'/ Task: accessor method for module name 
./ Return Value char? 
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char*® Boid: :getModuleName(} ( 
return Bold .ms_ModuleName; 
}// getModuleName 
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Function Name initBeidFurncitbbOpject ‘object bbData “data 
Task. defines function for geometry cal bacw 
Return Vaiue void 
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2d Bord initBordFunc (bbObjert ‘object. bbData *data / 


GLfloat coords'4)[{3]) = ¢ { Of, =0 9¢, (ee rone 
Ci back ieft 
} Dace right 


/ top 
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0 
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giShadeModel (GL_FLAT). 

gliBegin (GL TRIANGLES} . 

{ 
gicolor3&(0 Of. 0 .Sf. 1 OF). / bottom 
glVertex3 fv (coords(0)). 
glVertex3fvicoords(z))., 
glVercex3 fv i(coords(2]). 


glcolorss(2 OS. 055270 Of), /# lefte 
glVertex3fvicoords(0)). 
glVertex3ivicoords(1)}). 
glVertex3ivicoords{3}), 


glColor3£i(it O£. 0 SE. 1.08); /* yvaght 
glVertex3fvi{coords{0}}, 
glVertex3fyv(coords({3]}. 
glVercex3fivicoords(2)}). 


glColor3£(0 Of, 0.5£. 90 Of), // pack 
glVertexi3fvicoords{1l]}). 
glVertex3 fvicoords{2]). 
glVertex3 fv (coords[3}). 

i 

glEnd({). 

gl ShadeModel (GL_SMOOTH). 

}//end in:tBoidFunce 
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‘/ Punetion Name initBoidGeometryi{)} 
‘/ Task attaches the function for geometry callback to the Visual Module 
/ Return Value void 
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void Boid .:nitBoidGeometry ([} ( 


myGeom = new npsGeometry (Bold::initBoidFunc). 
myGeom->set BoundingSphere (npsVec4£(0.0f,. 0.0£. 0.0£. 1.0£}). 


)/¢4 end initBoidGeometry 
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// Punetion Name setLocalObject (RTI :Boolean flag} 
// Task: set the object as local or not 
// Return Value: void 
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void Bord: -setLocalObject{RTI: :Boolean flag) { 
localFlag = flag. 
} 
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// Funetion Name: localobjecc{) 
// Task: accessor method for local object flag 
// Return Value Boolean 


Lf Se SPHH ee HeeHeereererereHereeeHeeeeeseerEeETETELeSELeEeELELeEHeLeneeee 


RTI::Boolean Boid::localdObject () ( 
return localFlag; 
} 


Lf Peeeeese esses eeeeee et eH ESS SSFHSSF SSS HSeTeRZ ESE SSE EESTHBEHHHS EF ESEB EEE e 


// FPunetion Name isTerrain() 
// Task: informs amHLAAdmin whether the object is a terrain object or not 
// Return Value Boolean 


PE SPECHT HE EHEHSSESHEHR SHE SHS SHH ESHEETS H HS HSEHSEHSHSHEH HE SSHHHSHHHHEHSSHSHEHE SHEE EHOS 


RTI:: Boolean Boid: ::sTerrain({) { 
return RTI: :RTI_FALSE: 
) 


ff PPPS eeeeereerereraneesrereeresrereererereneneaeeevresaetesreeLereeeeeoeeeers 


// Panction Name: checkCollision{amObject* that) 
// Task: returnds true if there 15 a collision with this object or not 
// Return Value: Boolean 


ee SHO SHSSSHS HEH HEHSSHSHEHS SEH SES SEH SHSHHSHSHHOSHSHEHHESHTHEHHSSSHEHHHTHSSHHOOHH HEHE HOE 


RTI:: Boolean Bord: :checkCollision{amObject* that) { 
RTI::Boolean flag = RTI.:RTI_FALSE. 
2f (that != chis) ( 
if (distanceFrom(that->getPosition{)) < 2) ( 
flag = RTI-:RTI_TRUE, 
}/fend if 
}//end if 
return flag, 
}//end checkCollision 


li SHPO SHOHSHSHSS SHEESH ESE HES SESS SHHSHSHEH SHH HES ESE SSR HSHHHHEHSHHHSHHHHEHHHHOHOEHE 


// Punetion Name: hasCollided({) 
// Task: checks if current object 1s collided with any other obaject 
// Return Value Objeceibd 


Lf TESS SSHSHHSEHH SEH HEH SH EHHEHE HEHEHE SESE ESHH HEHEHE HHHEHHEHE SHH HSHEOHHETOEOE 


RTI.:ObjectID Bord: :hasCollided!) ( 





/¢ loop amObject array 

// compute distance 

RTI: :ObjyeccID oid = 0; 

amObject* tmp = Admin: :checkEntityCollisionithas) ; 


2£ (tmp && (tmp '= thas} ){ 
1£(( (ump->getVelocity()).length() < {thas->getVelocity()) .lengtht))) ( 
oid = tmp->getEntity!ID(); 
}//end if 
}//end if 


return oid, 
}//end hasCollided 


ff ee eee ee eeeecererseeresresreveseseseeseseseseveseseseeseesesesresesesece 


// Pumetion Name. distanceFrom(npsVec3£ thatPos)} 
// Task finds distance between two objects 
// Return Value float 


Lf SAHSSSTSCHESHSESHHEHOSSEHOHOCHHEHHSESHEHHESOHOHESOHO BEES SO HSESE SECO EEESEEOES 


float Bold: :distanceFrom(npsVec3£ thatPos) { 


npsVec3£ thisPos = this->getPositioni); 
npsVec3£& tmpPos; 
tmpPos.sub(thatPos, thisPos} ; 


return tmpPos. length(): 


}//end distancefrom 


ff SPSS SHH SESE SHES eH ED SHED EHH EEE SEH ESSE ESHHEEHHHSSHH SS EST EHHEHHTEYOEVES 


// Panetion Name- checkTerrainCollision(amObject® that) 

// Task: returns y value for terrain to provide rudimentary terrain 
if collision detection -- 0.0 because not a terrain module 

// Return Value void 


[f SEPP Ceeeee eee eeeDeeeeSEEeS ESO HEE SHOE HHOHSHHS OD ESE LESSEE V OLE OOS 


float Boid: -checkTerrainCollision(amObject* that) { 
return 0.0; 
)//end checkTerrainCollision 


amArena Files 


LL SE SSS SC SCHOS SES SHO SOSSSSSSSSHHHSSSTSS SH SHSSSSSHSSCHHHEHHHOH SHOOT TOSSES 


4é EXECUTIVE SUMMARY 

ff 

// File Name module.h 

4/ 

// Author: CPT Stewart Liles. Naval Postgraduate School 


Le 

// Deseription: This file defines the global functions required by every 
tf dynamically-linked library. How these functions are 

ff amplemented is arbitrary, but at is useful have RCS 

tf automate some of the work. 

tt 


// September 1998. Masters Thesis 


Lf 22S 20 e Oe 210018 0) 82) S008 (09 6 Cle 6.6 a6 S 6.0 Fe 0 6) 89.066 .O'* 6016'S 0.0 0:S S104 (0/6 018006) 86.0.0 


wiftndef _ module 
define module 


Lf SOSSSHCHSSHSSHSHHSSSSEHSSOH OHH ESTES SHOT OTH STTESOTSSS ETERS SHE ESET EF EROS 


‘f/f INCLUDES AND EXTERNS 


Ff SOS SCS SOC OCS OES OOS HS OOS OOOOH SOSHOH SSS OSOHHSOHSCSOCOHOH OE OCOSSEO COS FOOEO 


sé SHFSSSSSESSHSSSSSSSSSS SS SSeS SSeSseSeeSeseeeSeeeseseeseeeSeeeeeeoeooseee Fee ee 


ff DEFINES 


Lf SH SSHSSSSSEH SOS OCS SSS SEHHH SSS EHHH SHES SES EHO HTEOEH ESOS SHOE TER OHO OCBEBEERDE 


Lf SISPSHSSHSSHSHHSHSSSHSSSHSSHSHSSHHSESESSSSESSSSS SES SSEHHHT ESSE FESTSEHT TET OE 


4/ FUNCTION PROTOTYPE SPECIFICATIONS 


PF) ake eS) 9) 819,57 9198819) Se 91S SESS) SOC O88 S'S) 6.8 FS 6:6, 0) 000109010) e) ©) 0) S) C18 SC) 69'S) C19) 616) 9:02) ©). 


wifdef _ cplusplus 
extern °C° { 
wendif 


ADMIN_API const char *getModuleName(); 
ADMIN_API float getModuleVersion(}; 
ADMIN_API const char *getModuleDate(); 
ADMIN_API const char *getModuleText (); 
ADMIN_API bool initModule{); 

ADMIN_API bool exitModule({); 


e:fdef __cplusplus 
hs 
tend: f 


wendif // _ module 


This is the module ctxt frie for amarena module 


Bambool Ob 


bbKeybosardModule 
npsVisue.Module 
anHLAAdmin 





ay SSSHC SSS SS SS SHS SSS SHSSSCSHSFSSHSESSS SPSS FSFE SFFSSSFFSSSFSCSFSSFSSSSOH#SsSsesSseses 


4/ EXECUTIVE SUMMARY 

// 

// File Name. module.c 

‘/ 

// Author: CPT Stewart Liles, Naval Postgraduate School 

4/ 

// Deseription: Thas file defines the global functions required by every 


Lil dynemically-linked library. How these functions are 
tt amplemented is arbitrary. but it is useful have RCS 
f/ automate some of the work. 

/f 


// September 1998. Masters Thesis 


Lf Serres eevecvesererscereveveseneseneoesesrcveeneoeseseressvoneCseen ee ele Vee 


ff SHPSCHSSH HESS SELES SLES ES SSH SSHSHSSSESHSSSHHESSEESHESSHHTSSSSTSESSSSET ET SES 


it INCLUDES AND EXTERNS 


ff Pe eeePeeretereccvereoveseoreveveseserescerecetereeeerserseessseseece 


#include <stdio.h> 
#inelude <stdlib.h> // atof 


include *module.h°* 
#include *amArena.h* 


LL CLS Oe S600 :0)0: 8 S18 (8S O18:S CC COC: 8:0 09019610 0/9 C08 C'S 2'e 89 2102S 010 92 O00 6.0 0 0,0 Sie eo 2 


if DEFINES & FILE SCOPE VARIABLES 


4/ ePeeeePeeeeeeeeeeee ee seeeeeseeeeeeeeeseeeeeeeeeeeeeeevevreeeeneeeeeeeee 


#é SSCSHHSSSS SSCS SF SHSSV SF Fee FFF eseFFeseFFFeeFFFeFeFFFFFFFFSseeFFFFFSeeTHee 


// CODE 


JL SS 2:6 0.66 018 S1O1e 6 O10 0 O10 FO. 8S 4 OF FOS FF F&O 'S OOS OO 646 OOO 0006 OC 010) 0.6)0 88 8.9.00) 0:8)? 


const char *getModuleName[} 
{ 
return “amArensa’; 


} 


float getModuleVersion () 
{ 
return 1.0£; 
} 


eonst char *getModuleDate() 
( 
return °1998/08/01 06:00:48°; 
} 


const char *getMoeduleText (} 





*@aeeereeeeee ee ee ee eta aeeeGeaereeeet eee ee eeeeeeeeeeeeeeeeeeeenznenenevenn- 
return °amArensa Terrain module T -4 Wad-, EXE UTIVE SUMMARY 
} 

Fi.e Name amArena ?. 


Author PT Stewarr Liles Naval Postgraduate School 
bool initModule!) 
{ Description defines metheds pertinent to module loading and unloading 
wnitamArena }. 
return 2}, September 149+ Masters Thesis 
} CO me Cee cm ee mecca ne cc e nee moe cee ee ce ecen eens cece ee eessccceceeeeece 
# fndef _amArena 
bool exitModule( wdetine _amArena 


( 
exitamaArena ( 


return i, f @@ PCP eeetet eer eeeeee ter ates eeeeeeseeeeeaeeeseteeeeeest®eeeereeseeeeees 


) INCLUDES AND EXTEPNT 


eeeeeeeeee ett eeesee sees ee S28 e est eer eee2eeeFeeeseseeseseeeeeeeseanee 


fF PHPCHSHSSSHHHTH SSS SOSH HHH HE HE HHH SHEESH EHO EH HOSE ESZEEeS SESE FESESHE HES 


DEFINES 


eoeer ee eee eee eee FF ee et Feeeees etter eHtTeHSFeHeSeseee eee eFeteeereeesees 


eoeeees en ee See een eee ee Fees et TESSSSSSSSFSSF eet eee Heese SEeeeteeeee 


FUNCTION PROTOTYPE SPETIFICATIONS 


Ce ee ee ee ee ee ee 2 ed 


void initamArena(}, 


void exitamArenal:, 


if See ehee eves eeeeeeeneseeeseeeee see Ste wesneseeseeeeeeee Severna eeeeeeeaee 


; INLINED MEMBEP FUNCTIONS 


, PP See eee ee Bee F FFF Heese More SBBZFEBFOF SEH eEE SESS ESSESS SES SESE HSHHE SEES 


Wendsf // 











poe @eweoweeeeeeeeeeeeeeeeeeeeeeeeeeeeeevneeeeeeeeeeeeeeeeeveeeeeeeeeeeeee Fi prototypes 

/f EXECUTIVE SUMMARY void initKeyboardModule(), 

Li void initVisualModule({}, 

// File Name. amArena.c 

f/f // instance a Arena Object and pass it to the module array 

// Author CPT Stewart Liles, Naval Postgraduate School myArena = new Arenal), 

t/ Admin addModuleFunctionPointer (myArena), 

// Deseription: defines methods pertinent to module loading and unloading 

‘hid //this 1s a Terrain module so if one already exists we must delete it 

// September 1995, Masters Thesis r1f (Admin: ms_Terrain) { 

ff Peewee eeeeeececesresesrseeseesereeeseeesessessesHeeeseeeeeneeeeeeneetesn Admin unloadModule Admin: .ms_Terrain->getModuleName(}:; 
}//end 1€ 

J/ Poveeeeeee ee eee eee eee ees eeeeeeeeeeeateeseeeeeeeeeevoenvteveeeeeeeeeneeee anitKeyboardModule(); 

Lt INCLUDES AND EXTERNS 

th ee f/ null my Arena tor future use 
myArena = NULL, 

#include °Rti-.hh° 

Winclude *npsVisual h° // add object to the federation 

sanclude ‘*npsWindow h° 1f£('myArena) ( 

include *npsViewport h°* RTI :ObjectID oid = Admin. registerObject{), 

#include *bbMouse h° amObjyect* tmp = Admin.: fandModulet*amArena’;, 

#include °bbKeyboard h° npsGeometry® arenaPtr = npsGeometry -findObject (°amArena_Geom®), 

#include *bbEventResponse h° rf (!arenaPtr) ( 

include “bbCallback.h* snitVisualModule), 

Winclude “npsGeometry.h° } 

®include “Arena h° myArena = (Arena*)tmp->createObject (oid), 

#include °amHLAAdmin h° myArena->setLocaiObject (RTI: RTI_LTRVE). 

®anclude “admin.h°* Admin..ms_Terrain = mryaArena, 

fWinclude "amObject h°* }/fend af 


// thas allows Arena to update to rest of federation 
ifimyArena) { 


include <math h> myArena->setUpdateFlagiRTI .PTI_TRUE). 
Winclude <GiL/gl h> } 
wifdef SGI cout << “anitamArena’® << endl, 
#include °“bbSGI.h* 
tendif }// end initamArena 


ff Sere ewer estasecsreeseeeseseeeereseseseseteseseseseeseeseeseeeeeeneeees 
if CODE 


ff Pe ee eeeeeccecccccseccceceneseeveseverseesesserveseeeneeeresereseseseoren 


ff Pee eee ees evreesereecczscesese eee eee ee THESE HEHEHE EH EE SEH HEHE E HH EE® 


// Funetion Name exitamArena (| 
// Task: does housekeeping required to exit the Module -- 


Arena *myArena, if thas is run only once 
// Return Value void 


void exrtamArena(} [ 
bbCallbackHandler *callbackHandier, 


f/f See ee eset et eeeeseeeeseteetrebtoneseseseeeeeeaeeseseeeeeeseeenseseeenen 


// Funetion Name instamaArenat} bbCallbacx *callback, 
r? Task initialize Module -- this is run only once bbKeyboard:* keyboard; 
// Return Value void bbEven: Response*® event Response, 


Lf eee eeeetoceceee ee eeeeeeteeheseeteoaeez eevee eeseeteer eevee eveeeeeeetetevone 
keyboard = bbKeyboard: getinstance j. 
void initamArena() ( 


ant mouselInWindow!{) A? eeoeeee ee eee ee eee eeeTeeeTeeS eee SSS SSeS HHO SSeS SSE eeEe Fee eeeeeeeTee ee ee 
| {f/f remove keyboard callbacks 
' 
| 


yvadArena callback veyboard- -addEvent Response |eventResponse, 
eventResponse ~- bbiEventResponse 7 1Ibyecs SamArensER_Terrsain* 
taesback - bbCallback tindObjer: ‘amarena_Terrain®), 
eventResponse->removecal.back cal. bach 
delere callback. 
rcamove remote amObjects COSTES SH SEH SHE HSSHES SOFT SHSSHSHSHS SHEESH EHHEHOHS OHSS EHROEHKTHSHSH OSH HSHSH HOE SEHR BOS 
rsiiAdm.n ms_Terrain) { Function Name initvisualModule 
Admin removeAmObiect Admin ms Terrain +jecEntityldD,) | Task. set the geometry for the Arena 
Return Vaiue void 


SCHHSS SESH STSESHSSHTHSSHTSHEHHSSHSHSHTSEHTSHHH HESS HETHEHSSHE BEES HSH SHEESH BOB SHOES 


remove local obsyect 


uf *myArena | M2d anitViasualModu.ey: / 
npsGeometry® tmp npsGermetry findOoject) “amArena_Geom*) . 
+f (tmp) void inithrenaFune: bbopjyect cobjyect bbdata “data: . 
delete tmp 
end else NnpsGeometry "arena, 
semove the module trom module list * anit geometry 
Admin removeModule!*amArena” , arena = new npsGeometry (snitArenafunc , 


arena->setName “samArena_Geom’), 


Admin ms _ Terrain NULL. 
+f end initVisualModule 


Tout << “exatamaArens” << endl. 


end exitamaArena 


CO eee SRS EHS EHSHH HESS EHSHE SHE EHEHH ET SEHEHSEHTHSHSHHSHHHEH ERSTE SDHHHHRHEHHH HEH HEHEHE 


Function Name loadArenaibbObject ‘object bbData “*data, 


eeeeee ee ee SSeS F SSeS FSes sees eeseeseSFSFFSSSeSeseseseeseseeeoeszreeoeaeeeeea eee ee 7 Task: function defined for the loadArena keyboard callback 
Function Name initKeyboardModule,) ' Return Value void 

Task add keyboard callbacks is eeeeeee eee teen eae eteeeee ee eeeteeeeeteaeeeeeeeeeeeeeeeeeeeeneeeeeneeen8@ 
Return Value void 

Co Pee Se SHS SHS SHEE HS SHES SHS EESESSEES SHEESH HSHES SSS SSOS ECE RESO HEBER EEEOOH OES OE vod losdArena (bbObject *object, bbData *data) ( 


Void initVisualModule(), 
void initKeyboardModule() 
{ 1£ (mouseInwWindow(} } ( 

cout << *loadArena® << endl; 
vo.rd escFunc(bbObject *obyect, bbData “data). 
void resetFune(bbOb3ect ‘object. bbData cdata), 1f(imyaArena) ( 

volrd loadArena(bbObject ‘object. bbData “*data), //add Arena to federation if does not exist 
RTI. .ObyectID oid = Admin :reg:sterObject(), 

















bbKeyboard *keyboard; amObject* tmp = Admin: :findModule/*amArena’!, 
bbEventResponse saventResponse. npsGeometry® arenaPtr = npsGeometry:-findObject (*amArena_Geom’), 
bbCa llback *callback, rf ('arenaPer} ( 
ynitVisualModule(), 
get the keyboard device } 
keyboard = bbKeyboard :getInstance }, myArena = ({Arena*)tmp->createObject (o1d} ; 


myArena->sectLocalObyect (RTI: -RTI_TRUE} , 
Admin.:ms_Terrain = myArena;: 

'+ sat up load boid key }/sand if 

eventResponse = new bbEventResponse (bbKeyboard: .KEY_T | 
bbKeyboard: : DOWN_TRANS], 








//set flag so Arena is updated and the rest of the federation 


event Response->setName (*amArenaER_Terrain®}; // will discover the object 

callback = new bbCallback(). if (myArena ) ( 

callback->setName (°amArena_Terrain®), myArena->setUpdateFlag(RTI RTI_TRUE!, 
caliback->sectFunc{loadArens), } 

eventResponse->addCallbackLasc (callback), }//end if 





giBegin(GL_TRIANGLE_STRIP} ; 
{ f/start gi 


POSSE SESS HSHHEHS SH HSHEHH HEHEHE HHHSHS HHH HEHHHHOSHTSHHES EHH EHSHEHSEHS HHH EE ESEEEE for (j=0; j<NUM_VERTS_WIDE; jor) ( 
Function Name: initArenaFune({bbObject ‘object, bbData *data) if (colorToggle) { 
Task: function defining the Arena geometry colorToggle = 0; 
Return Value: void giCcolorgito.0£, O06, 1018); 
@e@neeteteeeeeteteaoeneeseeeseeoueeeoeoeo ee eoueo eee eeen tease eeeeeeeeeeeeeeeeeeeeeeneene } 
else( 
void initArenafunce(bbObjyect *objyect. bbData *data) { colorToggle = 1; 
npsGeometry *geometry, glColorsf()0c, 1-0f; 1cOCls 
want displayListNum; } 
const float CELL_LENGTH = $.0; ¢currVert = 1°NUM_VERTS_WIDE + j; 
ifdef VISUALCPP glVertex3fv (coords (currVert])); 
const unt NUM_CELLS_LONG = 10; 
const uint NUM_CELLS_WIDE = 10; currVert = (i+*1)°NUM_VERTS_WIDE + j; 
#@elif SGI glVertex3 fv (coords(currVert]); 
const uint NUM_CELLS_LONG = SO; J//end for 
const uint NUM_CELLS_WIDE = $0; if { NUM_CELLS_WIDE & Oxl j( 
fendif if {colorToggle}) 
const uint TOTAL_NUM_ CELLS = NUM_LCELLS_LONG °* NUM_CELLS_WIDE; colorToggle = 0; 
const usnt NUM_VERTS_LONG = NUM_CELLS_LONG ~+ 1; else 
const uint NUM_VERTS_WIDE = NUM_CELLS_WIDE + 1; colorToggle = 1: 
const uint TOTAL_NUM_VERTS = NUM_VERTS_LONG * NUM_VERTS_WIDE; } 
uint i, j. currVert, currindex, currCell; )//end gl 
bool colorToggle; glEndt{); 
)//end for 
Ufloat coords (TOTAL_NUM_VERTS] (3); 
GLfloat normals ([TOTAL_NUM_VERTS) (3];: /f/ walls and ce:ling 
GL£loat textures (TOTAL_NUM_VERTS] [2]; //North wall 


glBegin{(GL_POLYGON) ; 
glcolorst(0.5£.0..5¢.0.S£1; 


f/f TAG Vals glVertex3£ (-25.0£,0.0£.-25.0€£). 
colorToggle = 0; glvertexi£(25.06.0.0£.-25. 08). 
for (i=0; L<NUM_VERTS_LONG; i+) { glVertex3£&£(2S5.0£,.50.0£.-25.0£). 
for (3-0; j<NUM_VERTS_WIDE: j++) [ glVertex3£(-25.0£,50.0£,-25.0£); 
currVert = 1°NUM_VERTS_WIDE + j; glEndt); 
//South wall 
coords (currVert)(0} = (CELL_LENGTH ° i) - | glBegin (GL_POLYGON} ; 
(NUM_CELLS_LONG*CELL_LENGTH°0O.S£); gicolor3£(0.6£.06.6£,0.6£); 
coords (currVert)]{1] = 0.0£; glVertex3£(-25.0£.0.0£.25.0£)}; 


coords (currVert) {2} (-CELL_LENGTH * 3) - 
(NUM_CELLS_WiDE°*CELL_LENGTH*O.S£); 


glVercex3£(25.0£,060.0£,25.0£); 
glVertex3 £(25.0£.50.0£.25.0£); 


normals(currVert] (0] = 0.0£; glVertex3 £(-25.0£.50.0£.25.0£), 
normals(currVert) (1) = 1.0§; glEndt): 
normals(currVert] [2] = 0.0£: //West wall 


textures (currVert) [0] (float) i) / (NUM_VERTS_LONG-1) ; 


= glBegin(GL_POLYGON) , 
textures (currVert)] (1) = ( (float) j}) / (NUM_VERTS_WIDE-1); 


gicolor3£(0.8£,0.S5£,0 4£); 


}//end for j 
}ffend for 1 


glShadeModel (GL_FLAT). 


colorToggle = 0; 


for {i=0; i<NUM_CELLS_LONG; <<<) ( 


glVertex3£i-25.0£.0.0£, 25.0£). 
glVertex3 £(-25.0£,0.0£,-25.0£!; 
glVertex3£(-25.0£,50.0£,-25.0£); 
glVertex3£(-25.0£,50.0£.25.0£); 

giEnd(); 

/fEast wall 

glBegin (GL_POLYGON) ; 
gicolor3£(0.4£.0.5£,0.8£); 
glVertex3£{25.0£.0.0£,-25.0£). 


i a ee ee ee a eee eee 


giVertexs:(25 OF Ot 2 Of 

giVercex3s (25 Of tae Of.25 08 

gliVercex3f(25 0f.50 Of,-25 OF 
gl&ndi) 


“/Cer.ling wail 

glBeginiGL_POLYGON) . 
glColor3£(0.8£.0 8£ 0 8£f). 
glVercexsé(-25 Of Sc Of (25. Gf 


glVertex3£(2$ Of SO Of -25 9 
givercexse( 25 08.50 68 225 3% 
glVersex3&1-28.0f£.50 Of 25 Of 


glEnd()}. 


glShadeModel (GL_SMOOTH) . 
wnitaArenazunc 


eee eeeeeneeeeeee ese eee eee eeeteeeseeeeeseeeeteFevetoesteeeeoeteeotaaneere 


Function Name mouselInwWindow 

Task tells 1f£ mouse is in the correct window to receive keyboard 
commands 

Recurn Value int representing boolean 


unt mouselInwWindow({) ( 
int flag = 6. 


npsWindow *window, 

npsViewport *Viewport, 

window = npsW:ndow  findObjecct (*Adminwindow") . 
Viewport = npsViewport findObject (°AdminViewport’). 
Float xy, 

x = bbMouse getXxi), 

y = bbMouse getYt), 

bbScreen. -normalizeVal tax.sy). 


2f (viewport-»getWindow()]->1sValInside (x.y) ) ( 
flag = 1: 

) 

return flag. 


eeceweeeeeeeeee eee ee eeee ee etn -- Fs SoH HHH OHH eeeeseeseeeeeeeeeeeeeeeeene 


EXECUTIVE SUMMARY 
File Nam@ Arena h 
Author CPT Stewart Liles. Naval Postgraduate Schooi 


Description method definitions for the Arens class -- 
Arena class represents the class tnat 15 :mplemented by the amAsrena 
module 


Septemper 199% Masters Thesis 


Cee asset SSF SBS SHSHSHEHREH SHES HOHSHHHE EOD SHEHOHEHOHHOOHHHORHEHH OHH OHHH OE 


Binclude “Rei Rh* 
#include “npsVecif.n° 
include “npsGeometry h° 
#include ‘obKeyboard h* 
include *amObject h°* 
#znclude °admin h° 


ifndef ADMIN_API 
arifdef VISUALCPP 
#define ADMIN_API __ declspeci{dllimport) 
felse 
edefine ADMIN_API 
fendif 
fendif 


class ADMIN_API Arena public amObjecc 


/memeber variables 
public 
/? Extent data memebers 
stactzc Char® ms_ModuleName. 


private 


// Change flags for acttibucte values, 


RTI- :Boolean localPlag: 
RTI. :-Boolean updateFlag, // flag so only single update 


/ member functions 
public 


Arena(), 

Arena(t RTI .ObjectID id}: 

void setLocalobject (RTI:: Boolean}: 
void setUpdateFlag(RTI-:Boolean}. 


Virtual ~Arena(); 





virtual void display(); 


virtual amObject* createObject (RTI: :-ObyectID o1d); 

virtual char*e getModuleName({} ; 

virtual RTI: :Boolean localObject(}; 

virtual RTI::Boolean isTerrain(}; 

// Methods acting on the RTI 

virtual void sendUpdates(RTI.:FederationTime newTime}, 
virtual void 

sendUpdates(RTI.:ObyectID, RTI: -AttributeHandleValuePairSets. 

RTI::FederationTime, RTI::UserSuppliedTag). 


virtual void receiveUpdates(RTI::ObjectID ord. 
const RTI :AttributeHandleValuePairSet& hvps. 


RTI::PederationTime ft. RTI-:UserSuppliedTag cag); 


virtual void sendInteraction (RTI: :InteractionClassHandle. 
RTI: :ParameterHandleValuePairSet&, RTI::FederatronTime, 
RTI: :UserSuppliedTag) ; 
virtual void sendInteraction(RTI::FederationTime). 
virtual void receivelInteraction( RTI: :InteractronClassHandle 


theInteraction. 
const RTI: :ParameterHandleValuePairSet& theParameters }; 


virtual void receivelInteraction(RTI--InteracctionClassHandle. 
RTI: :ParameterHandleValuePairSets&, RTI::FederationTime. 
RTI: :UserSuppliedTag} : 
virtual RTI--Boolean checkCollision(amObjyect*® that): 
vartual float checkTerrainCollision(amObject* that), 
Virtual void deleteObject(); 
protected: 


RTI: :-AttributeHandleValuePairSet* CreateNvPSet (). 
}; 
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ff TeeHoececeesscesesssevoeseeseeenaesseeeessesreesessessesesreeeseeogeststenoevseoenece 


if EXECUTIVE SUMMARY 

da 

¢/ Frle Name Arena.c 

ce 

‘/ Author: CPT Stewart Liles, Naval Postgraduate School 
$& 

// Description: method definitions for the Arena class -- 


i] Arena class represents the class that is implemented by the amArena 
if module 
tf 


// September 1998. Masters Thesis 


ff OES OS 86 O860)6 900088 SS OF Oe OOO Be 8 HONS OG. w ie GOS 68 6 S18 e616 S16 61016 m ie O18 aieieieie 


include “RTI.hh* 
"include *Arena.h°* 
#include “npsGeometry.h* 
“include *“bbKeyboard.h° 
#include <GL/gl.h> 
#include *admin.h®* 
include *amObject.h° 
finclude *amHLAAdmin.h° 


/? Extent data memebers 


char® Arena-:ms_ModuleName = “*amArena“, 


LI PLAUPL ERED TARELAATTATL IAEA ELATD ELL AL ALATEST IE ON AE EEE hte ea 
-/ Construction/Destruction 
ELELIAAAALLE REI MAALTL AL ALLEL S ALS EAL EL LASTS AO OLE La ef ato ala ate Re? 


/f @@eeeteoeetteoneeres On eeeeeeeeseeee teu He Hee eee eneeeeeeoneeweeteaeoeeeone 
‘ 


/f/ Punetion Name: Arenat RTI..ObjectID 14d) 
// Task constructor -- instance intializer 
// Return Value- void 


Lif FORO OS OTS 18) O.@LO 0 OF) SF OFS SC Se SOS SSS PS Se Se SPOS OS. 416: 8818S SSeS 8) Sie 8 eee 6 


Arena :Arena( RTI::ObjectID 1d) { 
cout << *Arena{oid)* «<< id << endl: 


setEntityID{id), 
npsVec3f£ xx; 
m.set(0.0f,0.0£.0.0f). 
setPosition (xx), 
npsQuaternion yy; 
setOrientation(yy); 


localPlag = RTI::RTI_FALSE; 
updateFlag = RTI: -RTI_TRUE; 


Admin: :ms_Terrain = this; 


end constructor 


e@rceeeeseeeeeeeereeeeseeeseeeseeeeeeeeeeetteeeeeseetereeeeeaeeeeneee 


Function Name Arena 5 
Task constructor - usel for object storage in ModuleArray 
Return Value void 


eee ee ee ee eeeeeeses ese eeeeteaeeeSeeeee2e2e282 e288 228 FF FFF eB HHSH EHH ET OEE 


end defsult cunstructor 


eeoeoeoeesceeoeeeeeeeeseseeeeeeesewreeeeeeeeeseeeseseeeeeteretesteaeeesend 


Function Name = -Arens(} 
Task destructor 
Return Value vosd 


eee e ree ee eee eeeseeeeeeeeseeeseeeresreSeZZeneeeeeeseetseeteseeonntree ae 


Arena -~Arens 


cout << *The arena geometry was just deletedin® 

<< *If you deleted the terrain agnore message\n°* 

<< *else a feterate just quat the federstion\n’ 

<< *PUSH T to display terrain’ 

<< endl 
apsGeometry® tmp = npsGeometry fandObject(*amArena_Geom’). 
delete tmp, 


end destructor 


SSCS SSSHSHOHSHSHSHSSHSSSSSST SET SH SH HES SS SHS SHEESH H OHH HHH HHSSSHSSCHHE SBSH ES EEEE 


Function Name sendUpdates (RTI Object ID ord 
RTI aAttributeHandleValuePairSeté& Ca, 
RTI FederationTime ft. RTI.:UserSuppliedTag tag! 
Task not amplemented an this module -- pure virtual function must 
have defan.tion 
Return Value void 


CHHOT SSS E ESS SHEET EOHTSHSHSH SHES HOT HHHSHHSHSHSHEHSHSHE SSH HETHESHTHESHHH EH EHSH HEH OS 


void Arena sendUpdsates (RTI: ObjectID oid, RTI .AttrabuteHsndleValuePairSets 


Ca: 
RTI FederationTime ft. RTI: -UserSuppliedTag tag) 
() 


SSSSHTSSH SESS SHESHEHSE SHES OHSS SHS HSH SSHHSHEHSHEHH HE HHSH HHO HEHEHE HEHHEH EHS HHEEHEEEe 


Function Name sendUpdates (RTI: :FederationTime newTime) 
Task: send handle value pair to rei for update to federation 
Return Value: void 


SOS SHS SSH SHESHSHHSSEHSSHSSHSHS SESS SHR EHTS HEHSH HSH HHSHHHHSH OHS SBS SHH SESH H SHEED 


void Arena ‘sendUpdates (RTI: :FederationTime newTime) ( 


void Arena .receivelInteraction (RTI: :InteractionClassHandle ich. 
RTI: -ParameterHandleValuePairSet& phvps, RTI::FederationTime fr. 
RTI: :UserSuppliedTag tag) 

(} 


FJ SPOSSSHHHESSHESHSSHSSHEEHHHHSSHHHHE HEHEHE SHESEHSESSESSSES SSS SHESHHSEHHTESHEOOS 
a 


+/ Panetaon Name receivelInteraction{ RTI: :InteractionClassHandle 
theInteraction, 


tf const RTI: ParameterHandleValuePairSets theParameters ) 
// Task: not amplemented in this module -- pure virtual function must 
ve have definition 


// Return Value: void 


ff PP SHHHHHH SHE SSE HE SHSSH EE SEHESE FEE SESE SEE EE HEE EBS EEHHHESHHHER SHOES OOES 


void Arena: :receiveInteraction( RTI: :InteractionClassHandle theInteraction, 


const RTi.:ParameterHandleValuePairSet& theParameters ) 
{)//end receiveinteraction 


Ff SPCCHHS CEH SEH EEHSE OSH OEE ESESEHSH SHO SEHSESEOHOHD SESE SSESHESEHDSEEEHSES SS 


// Function Name sendInteraction(RTI.:FederationTime ft) 

// Task: not amplemented in this module -- pure virtua: function must 
f have definition 

‘é Return Value void 


LJ SE SOHH SOS SS SHHHSOHEH HSS HSH SHHSSSHSHSHHSESSOHSHESHTESCHHO OBE OH HOES SCOSO 


void Arena: :sendInteraction (RTI: :FederationTime ft} 
{) 


ff @@ SOS SS SSH STEHT SHH SHH SH SHS SHES SHS HSHHHEHHHSHSHHES SHS SRS HOHH HHH HHH HHH OHSS 


‘/ Panction Name sendinteraction(RTI-:InteractionClassHandle ihe. 

OB RUI:: ParameterHandleValuePairSet& phvps. RTI::FederationTime ft, 
of RTI: :UserSuppliedTag tag} 

‘{ Task: not implemented in this module -- pure virtual function must 
if have definition 

// Return Value void 


Ff SESH SHEHSHSSHHESH SOS EHS SHES HSH EHOEHOSESEHHH SESH EH ES HHEEESSSESCESOESSOH OO Ee 


void Arena: :sendInteraction (RTI: : InteractionClassHandle ihc. 
RTI. : ParameterHandleValuePairSets phyps. RTI::FederationTime ft, 
RTI.:.UserSuppliedTag tag) 

{) 


LL THSHHH SHH PHS H OH HE See EE SE DE HE SEH EH ED ETEHE DEES EEE EO SEE EEE ESE SESE OOS 


// Panction Name. CreateNvPSet {} 
// Task: creates HVP set pertinent to this object 
/é Return Value: AttributeHandleValuePairSet* 


ff PPS SSSSH SHES EHS SE RSH HEHE EH HEB E HEHE HD EHEHH EB EHSH EHH HHH BEH EES HE SOHH OBES 


RTI: :AttributehHandleValuePa:rSet* Arena. :CreateNVPSet () { 


RTI: :Attr.buceHandleValuePairSet*® pArenaAttributes = NULL; 


if (updateFlag) 
RTI AttributeHandleValuePairSet*® pNyvpSet TreatenmvPSet 
Admin sendEntityUpdate! getEntitysD') *pivpSe:. getModuleName! 


updateFlag = RTI RTI_FALSE, 
ifend aif 


end sendUpdates 


e@eeeareaeteoaa ee ee eeoeeeeeeeeovweaeeeGeoereaeanreeaeeeeeeeeee ee eeeeeeeeeeeeeee eed 
Function Name receiveUpdates{ RTI ObjectidD osd.conse 
RTI AttributeHandleValuePairSeti theAttributes 
RTI FederationTime theTime, RTI UserSuppiiedTag theTag 
Task decodes HVP trom RTI for this object 
Return Value void 


CCH HT SSS HH OSE ESTES EH SHEESH SEF OSES FESEEE EBS HOB ESE HES HEHEHE EEES 


void Arena receiveJUpdates{ RTI ‘Object ID oid.const 
RTI AttributeHandleValuePairSet& theattributes 
RTI, -FederationTime theTime, RTI UserSupp.iedTag theTag | 
RTI AttributeHandle attrHandle. 
unsigned long valueLength, 


/{ We need to iterate through the AttributeHandleValuePairSet 
‘s/ SO extract esch AttriabuteHandleValuePair Based on the type 
‘/ specafaed « the value returned by getHandle() } we need to 
‘/ extract the data frlom the buffer that 15 returned by 

// getValue([ 


for ( unsigned int 1 = 0; 1 < theAttributes.aizel;, 19¢ ) 
{ 

attrHandle = theAttributes getHandle! 1). 

af ( attrHandle == Admin: :getPositionAttrHandle() } 

{ 


npsVec3£ tmp, 
theAttributes getValue! 1, (char*)&tmp, valueLength }. 
setPosition(tmp), 

}/fend x£ 


)// end for 


}//end recevieUpdates 


ffl SPSS: O'S O60 O16 0:0 80'S 10 '@) O10 '6'0 0.0160 0:00 HOO: OO. OOF: O CC'S OC: 6:06: OO S'S: OCC 0 OPO: 0S RO CCDS 


‘/ Funetion Name receavelInteraction(RTI :InteractionClassHandle ich, 
tH RTI ParameterHandleValuePairSet& phyps. RTI: :FederationTime ‘ft, 
f/f RTI UserSuppliedTag tag) 

// Task not implemented in this module -- pure virtual fumetion must 
TE have definition 

// Return Value: void 


oe SCSSH SESS HSHE SSH HEHEHE SHEHSHSSHHEESHSHHEEHEHEHSHSHSHHSEHHEHSHEHSH SHES HHT EHTHHSHETEHHSEHEOD 


// Make sure the RTI Ambassador is set. 
1f ( Admin: :ms_rtiAmb ) 


// Set up the data structure required to push this 
// odjects’s state to the RTI. 


RTI. :ObjyectIDeount numAttributes(1):; 


pArenaAttributes = RTI: -AttributeSetFactory: :create{ numAttributes }; 


PArenadAttributes->add( Admin: :getPositionAttrHandle(),. 
(char®) &position, 
Sizeof {npsVec3£f) ); 


) 


return parenadAttributes; 
)ffend CreateNVPSet (} 


DE CESS TST HS SHETSEHEHTSHEHTSHEHS SHES HH SE SHTHSSHTHESHSHHSTESEHSHEHHHEHSHHHEHHHEHTHHEHHHEHOEED 


// Funetion Name display{) 

// Task: not amplemented in this module -- pure virtual function must 
tf have definition 

// Return Value: void 


ff SS SHSSHSTHES SSS SHEHSS THE SHH SHSHHSFTSHSSHSHSHSSH STS SHS SSH HS SHS SHSHHHEHHHHHHEHHHEBE OSD 


void Arena :display(){ 


)// end display 


Ji SST SHEHSHSSHRSSHSH EHH SEHSHSHSSHS HSE SSS HSHTHSSSHHSSH SHS SHHSHEHEHESHHEHEHEHEHTEHEHHHEH HEED 


// Panetion Name createObjyect ‘PTI: :ObyectID o2d) 
// Task: creates an object and returns a pointer to 1 
// Return Value: amObject* 


ff PP eeeeeeweeeesereccsresetesreseseseesrsesesesee se Seer eeresesaneseaeee oe 


amObject*® Arena: :createOdject (RTI: :ObjectID oid) ( 


Arena® tmpArena = new Arena(oid); 
return (amCbject*)tmpArena. 


J//end createObject 


LA SH SHSHSSSHSHSSHSEHS SHH SHE HSH SHH SHES SH HSH HSHHSSHSHT EH SHS HH SHH HS SHHSHHHHHSHEESSHEESEO EES 


// Punction Name: getModuleName [} 
// Task: accessor method for module name 
// Return Value char? 


aid SOHC SESHSHHS HSH SHH SESH SHSHH SESH HSHHSHEHSHEHSHHSHESHSHHHSHSHSEHSSSHHSHSHSSSHHSSSHSOHO OE 


char*® Asena: :getModuleName () { 
return Arena: :ms_ModuleName; 
dis getModuleName 


eeeeeeeeseeeeseret ee oe eeeeeeeeeeeerseeeeseeeeeeeteeerevreeteeeervereaevee ‘vag RT: Re SR 


Punctson Name setLocslObjyecct (RTI Boolean tlag 


Task set the object as .ocal or not -elling chery 
Return Vaiue void else .f that->getPosit.on go - @ uf 
ee ene eeeeeeseeseesesreee ee mee er eeeoreeee eZee eeHeeeeeeeteeeeeseeeeeeeoes ‘ ag: RTI TI_TRUE 
votd Arena setlLocalObjyect (RTI Boolean f.39 North wali cnecyx 
localFiag fisg. else if* that-sgetPosi:tisr 1 get i < 24 93 
1 tend setLocal Object f1ag - RTI FTI_TRUE 


south Wall cneck 


@veoevevveeeeee e222 Feeeeeeeteaaeteeveevarveeevoaeaevee een eeeeee eee 8288282828227 808 88 8 @ else eff that agetPosition je: 2) ~ ae ot 
Function Name JsocalObyect } f.a¢ RTI PTI_TRUE 

Task aztcessor method for local object flag } 

Return Value Boolean West wall check 
eeoevveevoveveeeeeeeepeeeeeeeeeeeeeeeeeeeeeneeaeaeeeaeaneeeeeaoeaeeveeeeeeveeeeeeee2 else 1£((tnat--getPositioni } get 0) a 24 of A 


£.8g = RTI RTI_LTRUE, 
RTI Boolean Arena localObject }{ ' 
return localFlag » East wall check 
1 ,end localdbjece else ifi(that-»*getPosition(;) getla) > 24 Ofj{ 
flag = RTI RTL_TRUE, 


eeeeeseeteeeteseet eet eer eeeeeeeeeseeeeeeseeereeneeeeneeaeeeeeneetesn 


Function Name isTerrain{} return flag. 
Task informs amHLAAdmin whether the obiect is a terrain objecc or not end cneckCollision 
Return Value: Boolean 


eeeeeerseeeeseeeseesee ee eres ee ee eee sen eee eee esesseeneeteneseteeeeaeeeeen 


~ 


eeeeeeeeese eee eeeeeeeeeeveesteeeseeseeeeseeeseeseseeseeeeeseeeeeeveseeves 


RTI. .Boolean Arena isTerrain !( Function Name checkTerra:nCollisioniamObject® that) 
return RTL RTI_TRUE. Task returns y value for terrain to provide rudimentary terrain 
)‘ ‘end isTerrain ‘ collision detection 


Return Value void 


eeeeeseeees ees ee eee ees e eevee eeeeeeeeF Sees eeeFeneeereetseatt ravens 


eee et eee ee eer eter mee et ros SSeSeeeeeeeeeeeeesezesesetanetevoseeeeveeoe 


Function Name setUpdateFlagiRTI Boolean flag Sloat Arena checkTerrainlollisionliamObjecct* thar / 
Task sets update flag -- used in send updates to decide whether to float yPosition =: 0.6, 
transmis a HVF or not 
Return Value void rf, (that-~>getPosition();.getill < 0 S$) { 
eeoeveeeeeeeeceeeereeeeeeeeeeeeeeeeeseeeeeseeeeeeseeeeeeneeeneeeevene yPosition = O Ss, 
) 


void Arena secUpdateFlag(RTI Boolean fiag) { 
updateFlag = flag. return yPos.tion, 
}/ifend setUpdatePlag 
)//jend checkTerrainColliision 


Jf SPP eC eesmerevessreccreeovecvrseseveceoevresreoevereneeoeoeeeFeeseoeeEeEeLee 


» Function Name checkCollisiontamObject® that) PF COOP HHO He meee eee ee ere EEE EHH SER ESE ET EE EH HED EE H EHH HE SHEED HOH HE OH ES 
‘* Task returnds true if there is a collision with this object or mot '/ Function Name deleteObject (} 
‘/ Return Value Boolean ‘? Task remote delete function 

i @eeoeeoeeeveeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaeeneeevneveeeeeveveeveeveeeeoeaee pee Return Value void 


iy Coevresetseeseeresneveeeeeeeeeeeeeese sees es seeeeeeeeeeeeeeeeeeeeeaeeeeor 


RTI: Boolean Arena checkCollisioniamObject* that) ( 
void Arena -deleteObject[) ( 
RTI.:Boolean flag = RTI RTI_FALSE., 
delete this. 
// €loor ckeck 
ifé{((that->gecPosition()).get(l} < 0 S£){ 





This is the module.txt file for amPageModule module. 
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amPageModule Files Serer edu 


bbMouseModule 
npsVisualModule 


Beet een tees eeeeeetFFeeee ee e222 2222228222272 SHB SH SEHHT OTHE SHEE BBO e Seoeeeeseeeee eee sees sess eeeeease eta aeHenreoseeeeesesesesesoeseeeenese 


EXECUTIVE SUMMARY EXECUTIVE SUMMARY 
| 
File Name module h File Name module c 
Author CPT Stewart Liles Naval Postgraduate Schoo: Author CPT Stewart Liles Nava. Postgraduate School 
Deser:ption defines methods pertinen™ tc modul# loading and un.ocading | Desersption def€ines methods pertinent to module loading and unloading 
September 1998. Masters Thesis Septerber 1998. Masters Thesis 
eevee eee eres eae easeeeeeeee ee eeen eee eeeeeeeee GGeetetseaueeeeeaneeeeneaesease @eerceeneeeeee ee ee ere ee eeeee eee eeteeoeeeeeoeeeeeeeeeaeseeceaseeoereeoeveaee ee 
®itndef _— module 
adefine module @eeeeeeceeaneeeeeeeeeeeeeeeeeeceeeeee eee eeeeee ee eeee eee ete eee eese eee 
INCLUDES AND EXTERNS 
eeeeeeevpeee ete eGezete ee ee eSeeete eat eee eSeeSS Sse eeeseeeeeeeee eee eee ee @eeeeeeeeorvr er eeeeeeeevneeeeeoervreeeeeeeneeveeeteoneeeeveevpeeeveeeeeeeeee ee ee easeaee 
FUNCTION PROTOTYPE SPECIFICATIONS 
CORSE SESE SEO EHS HEE HSH HHHSHEHEH HMSO HCHASCH SERB E BEEBE BEEBE EEE BEE Oe ®include "module h° 


include “amPageModul- h* 
artdef _ cplusplus 
extern — { ’ eeeeeveeeeeeeee es een eeeeeeeeeeeeaeeeteoenenee ee eeeeeeeaeeon eee eee eee ee Gee Gee 
tendif CODE 


SHOHSSHSHEHRHESHEHSSHHSHS HHS SHHHSHSHHHSTSHHHREHHSHSHHHSHSSHHHHSHHSCEHEHEHHSHEHHEHHHHOSH OE 


ADMIN_API const char *getModuleName(}. 


ADMIN_API float getModuleVersion }. ¢onst char *getModuleName/} 
ADMIN_API const char *getModuleDate( | { 

ADMIN_API const char *getModuleTexc i! return °amPageModule’, 
ADMIN_API bool initModule(). } 


ADMIN_API bool exitModule(). 
float getModuleVersion({} 


ifdef _ cplusplus { 

a return 1.0, 

bendif ) 

endif // _ module const char *getModuleDace{} 
{ 


return °1998/09/01 06.05 48°, 
} 


const char “*getModuleText! } 
{ 
return *This module enables the user to dynamically page modules in\n 
and out of the system via pressing the L and U keys respectively’; 


} 


bool initModule{) 
{ 
initamPageModule(:, 
return 1); 


) 


bool exitModulet{) 
{ 
return 1, 


} 





- EXECUTIVE SUMMARY i EXECUTIVE SUMMARY 

a File Name: amPageModule.h - File Name amPageModule.c 

A Author: CPT Stewart Liles. Naval Postgraduate School o Author: CPT Stewart Liles, Naval Postgraduate School 

fe Description: defines methods pertinent to module loading and unloading y Description: defines methods pertinent to module loading and unloading 
, September 1993, Masters Thesis i September 1996, Masters Thesis 

[ [POPC eee eee accccescacccscccrcaraccenaccresesetccescseccceteccscere J [POO m ere ee eee aaccces cas scccassssesrecseccereccccer cc ec sens scesess ce 


cf SOSH HSSHSHSFSH SSE SHHSHHSHSEHSHHHSHSHRHEHSSHHSHEHHHEHEHEHHHHHHHEHHOHEHRHHET HET HEOHHHHHOE 


ifndef _amPageModule 4/ INCLUDES AND EXTERNS 


fdefine _amPageModule J COPS e eee ee eee ceeeecereccasresascarsercsccccorcererseseereseseoeercece 


Lf POH PHHR SHA SEH HEHEHE HEEHEEEHEEEEHEEHEHHEHEEHHESESESEOH ESOS OH SES SOFTEE 


sf FUNCTION PROTOTYPE SPECIFICATIONS ®include *amPageModule.h* 

tf @eeeeonvneee Gove eaeeee G2eaevpaeaeaeaeaeseen eevee ee ee eeee Gee eGov eenenee Geese vneneeneenee@ ®include *bbKeyboard.h* 
®#include *bbEventResponse.h* 

void initamPageModule () ; include *bbCallback.h°* 
®inelude °“bbModule.h° 

wendif // _myKeyModule #include “bbMouse.h’” 


Winclude "“npsWindow.h* 
®include °*npsViewport.h° 


4/ SO SS SERS ESHSSHHSHHSHSHHSHSHSHHSSTHSHEHFSTHESEHS SHES HSHEHHHEHEHHHEHHHSHHHHTHHEHHHEHHEE 


47 CODE 


ff SO SSSESHSHEHSHS SHE HSHSHHSHHSHHSHSHSHSHSHHEHHHHSHHSHHRSHHESSHEHEHHSSHEHSHEHREEHEHHEOHHEHEEHEE 


ED COSHH HSEHSHEHSHEHHEHSSHHSHSHEHSHEHEHTEHH ETE SHH OHSETHHEHEHHSESHEHHSHHHSHEHHEHEET EE OHH 


// Panction Name initamPageModule() 

// Task: anmaitiralize Module -- this is run only once 
Lil sets up keyboard callbacks 

// Return Value. void 


4é SOSSHSESTSSASH SRST SHRHSSHOHSHEHSH HOSS HSSHHSHHSHHHHHRHHHASHEHE SESE HEHEHE EE HEE 


void initamPageModule() ( 
void loadFunc (bbObject ‘object, bbData *data); 
void unloadFunctbbObject ‘object. bbData *data); 





bbKeyboard *keyboard: 
bbEventResponse ‘*eventResponse; 
bbCallback *callback: 


keyboard = bbKeyboard: :getInstance(}; 


/f load medule key 

eventResponse = new bbEventResponse (bbKeyboard: :KEY_L | 
bboKeyboard: :CTRL_MASK | bbKeyboard: : DOWN_TRANS) ; 

callback = new bbCallback!); 

callback->set Func (loadFunc) ; 

enctResponse->addCallbackLast (callback) ; 

keyboard->addivent Response jeventResponse]) ; 


// unload module key 
eventResponse = new bbEvent Response (bbKeyboard: :KEY_U | 
bbKeyboard: :CTRL_MASK | bbKeyboard: : DOWN_TRANS]) : 








cai lback Aew bbCallback 
callback->secFune unloadFun. | 
eventResponse->raddcal lbackuast | tailback 
keyboard- >addEvent Response ieventResponse 


‘end anitamPageModule 


eeeeeete ee Re eeeeeeeeseeeeeeeeeeeeseeseeeeaeeFeeeeeseeereseoaesreerervene 


Function Name loadFunc(} 
Task callback function that loads modules 
Return Value void 


eeorerererer ree es eeeeeee eee eeeeeeeeeeeeeeeeeeee 220282288828 828828882888 8288088 


void loadFunc(bbObiect ‘object bbData *data: ( 
ant mouselnWindow(i, 


char moduleName[(64), 
chaz “ptr, 


rf tmouseInwindow! } } { 
cout << *LOAD- Please enter the module's name ° «<< flush. 


cin >> moduleName, 
cout << endl, 


1é'strnempimoduleName “http //*, 7)) { 
ptr = moduleName - 7, /? skip over http: // 
ptr = strrehriptr, ‘/'}, // make sure url well formed 


if C'per) { 
cout << * myDynamicPageModule Bad command line parameter ° «« 
endl, 
cout << * myDynamicPageModule URLs must be formatted as 
\°http ‘/<host>(/path] /moduleName\* ° << endl, 
cout << * myDynamicPageModule Example bamboo 
http: //watsen net/Bamboo/Modules/myRemoteModule® << endl, 
cout << endl, 
} 
*ptr = ‘\0'; // efficient hack 
rf ( *{perel) == °\0')({ // module can not be index.html! 


cout << myDynamicPageModule Bad command line parameter ° << 
endl. 
cout << * myOynamicPageModule URLs must be formatted as 
\°http //<host>([/path] /moduleName\* * << endl, 
cout << ° myDynamicPageModule Example. bamboo 
http: //watsen.net/Bamboo/Modules/myRemoteModule* << endl, 
¢cout << endl, 
) 
if ({'bbModule- load{ptr+-1l, moduleName} ) ( 
"ptr cs $/°s, ow put we back 
cout << * myDynamicPageModule Unable to load ° << moduleName <«« 
endl; 
cout << endl, 
) 
} 
else { // must already be on disk 


window = npsWindow: : findObject (*°AdminwWindow’}; 
Viewport = npsViewporc. : findObject (*AdminViewport®); 
floac X.Y; 

x = bbMouse: :getX{); 

y = bbMouse. :-getY{): 

bbScreen: :normalizeVal(&x,&y), 


if (window) { 
af (viewport->getWindow()->1sValInside{x.y)) { 
flag = ol, 
} 
} 


return flag; 


alll 





OR 


-t .'bboModule 9 loadimoduleName 
cout << ° myOynamicPageModu.e Unable tc, wead ° << mujuleName «<< 
end) 
cout << endl, 


end if 
end loadFunc 


COSTES SSH SE EHH EHH HS SH SHES SHRHEH EHS EHHEHHE EEO HSEHHEEH HEHEHE ESO EEE BEE EEE 


Function Name losdFunc )} 
Task caisback Sunction that unloads modules 
Peeurn Value void 


CC COS SESE HS SSE HHO SHH HEHE EH HSER HEHSHHOHSEEH HHO HEHE BET OHH OSH OB ERE EHBEEHTEES 


sid unloadPunc(bbObsecet *objyect, bbData cdata 
tnt mouseinWindow’. 


char moduleName([o54,, 
bbModule *module, 


if (mouseInWindow( | ( 
cout << °UNLOAD Please enter the module’s name ° << flush, 
cin >> moduleName, 
cout << endl; 


module = bbModule findObj)ect (moduleName 
if t'module) ( 


cout << myOynamicPageModule specified module °° << moduleName << 
25 mot currently loaded. .ignoring® << endl. 
return, 


) 


af (tbbModule :unloadimodule) } { 
cout << * myDynamicPageModule Error unloading ° << moduleName «<< 


endl. 
cout << ° Fatal Error - aborting executable'* «<< endl << endl, 
exit(do); 
} 
»/fend if 


so end unloadfunc 


SCOSSHSHHH SHH HHSEHHHHH HH HHSH SSSR OSES HESSHOHEHS HEHEHE EHH HHHSHEHES SESH SESH SHE OD 


' Function Name mouseInwindow(} 
Task tells if mouse is in the correct window to receive keyboard 
commands 
' Return Value int representing boolean 


eee eeF eee eee SSF SHFFSFS FF SFHFFHSHSSSEHSHHHHTHSHSHTHTHSSTS RSH HSRHH HEE EEHBSE HY 


int mouseInwWindow() ( 
runt flag = 0; 


npsWindow 
npsViewport 


“window, 
*viewport, 


72 


APPENDIX C: GLOSSARY 


attribute 
e A named portion of an object state. 
event 
e Achange of object attribute value, an interaction between objects, an 
instantiation of a new object, or a deletion of an existing object that is 
associated with a particular point on the federation time axis. Each event 
contains a time stamp indicating when it is said to occur (also see definition 
of message). 
federate 
e A member of a HLA Federation. All applications participating in a 
Federation are called Federates. In reality, this may include Federate 
Managers, data collectors, live entity surrogates simulations, or passive 
viewers. 
federation 
e A named set of interacting federates, a common federation object model, 
and supporting RTI, that are used as a whole to achieve some specific 
objective. 
federation execution 
e The federation execution represents the actual operation, over time, of a 
subset of the federates and the RTI initialization data taken from a 
particular federation. It is the step where the executable code is run to 
conduct the exercise and produce the data for the measures of effectiveness 
for the federation execution. 


Federation Object Model (FOM) 


e An identification of the essential classes of objects, object attributes, and 
object interactions that are supported by an HLA federation. In addition, 
optional classes of additional information may also be specified to achieve a 
more complete description of the federation structure and/or behavior. 

interaction 

e Anexplicit action taken by an object, that can optionally(within the bounds 
of the FOM) be directed toward other objects, including geographical 
areas, etc. 

message 

e A data unit transmitted between federates containing at most one event. 
Here, a message typically contains information concerning an event, and 1s 
used to notify another federate that the event has occurred. When 
containing such event information, the message's time stamp is defined as 
the time stamp of the event to which it corresponds. Here, a "message" 
corresponds to a single event, however the physical transport media may 
include several such messages in a single "physical message" that is 
transmitted through the network. 
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model 

e A physical, mathematical, or otherwise logical representation of a system, 
entity, phenomenon, or process. [DoD 5000.59] 

object 

e A fundamental element of a conceptual representation for a federate that 
reflects the "real world" at levels of abstraction and resolution appropriate 
for federate interoperability. For any given value of time, the state of an 
object is defined as the enumeration of all its attribute values. 

object model 

e A specification of the objects intrinsic to a given system, including a 
description of the object characteristics (attributes)and a description of the 
static and dynamic relationships that exist between objects. 

object model framework 

e The rules and terminology used to describe HLA object models. 

object ownership 

e Ownership of the ID attribute of an object, initially established by use of 
the Instantiate Object interface service. Encompasses the privilege of 
deleting the object using the Delete Object service. Can be transferred to 
another federate using the attribute ownership management services. 

Runtime Infrastructure (RTT) 

e The general purpose distributed operating system software which provides 
the common interface services during the runtime of an HLA federation. 

simulation 

e A method for implementing a model over time. Also, a technique for 
testing, analysis, or training in which real-world systems are used, or where 
real-world and conceptual systems are reproduced by a model. 

Simulation Object Model (SOM) 

e A specification of the intrinsic capabilities that an individual simulation 
offers to federations. The standard format in which SOMs are expressed 
provides a means for federation developers to quickly determine the 
suitability of simulation systems to assume specific roles within a 
federation. 

time management 

e Acollection of mechanisms and services to control the advancement of 
time within each federate during an execution in a way that is consistent 
with federation requirements for message ordering and delivery. 
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